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Preface 


Objectives 


This guide explains how to manage a RSTS/E system on a day-to-day basis, 
lb use the features described in this guide, RSTS/E requires you to have cer¬ 
tain privileges. Only the RSTS/E system manager and users with the required 
privileges should have access to this guide. 



Audience 


This guide is primarily for use by system managers and operators. You do not 
need to have a great deal of knowledge and experience with RSTS/E to manage 
a RSTS/E system. However, to perform certain system management tasks, you 
should understand how to use a text editor like EDT and be familiar with the 
Digital Command Language (DCL). 

In addition, because not all customers install their own systems, the manual 
includes information for Digital field service engineers and software support 
representatives. This information is clearly indicated. 



Document Structure 

This manual contains the following chapters and appendixes: 



Chapter 1 


Contains a glossary of RSTS/E terms and an overview of the 
RSTS/E disk structures, system management concepts, multiple 
privileges, account management, and file access. 

Describes procedures for starting, halting, and restarting RSTS/E. 
Describes what the system startup command file should include. 

Describes the phases the RSTS/E system goes through when shut¬ 
ting down. 

Explains the quotas that limit the amount of various system re¬ 
sources that users can have. 

Describes the privileges that you can assign to a user when you 
create an account. 

Gives background information on managing RSTS/E accounts and 
describes the DCL commands used to create and maintain the 
accounts. 

Gives background information on managing terminals and terminal 
servers, and describes the relevant DCL commands. 


Chapter 2 
Chapter 3 
Chapter 4 


Chapter 5 


Chapter 6 


Chapter 7 



Chapter 8 


xix 










Chapter 9 

Gives background information on the Print/Batch Services (PBS) 
package and describes the DCL commands for using PBS. 

Chapter 10 

Describes the available programs and DCL commands for managing 
system errors. 

Chapter 11 

Introduces the concepts of device management and caching control 
on your RSTS/E system and describes the relevant DCL commands. 

Chapter 12 

Gives background information on RSTS/E system files and logical 
names and describes the relevant DCL commands. 

Chapter 13 

Gives background information on RSTS/E jobs and describes the 
DCL commands for managing them. 

Chapter 14 

Describes miscellaneous DCL commands. 

Chapter 15 

Gives background information on working with disks and tapes and 
describes the DCL commands for managing them. 

Chapter 16 

Describes the DCL commands for backing up and restoring disk 
files and accounts. 

Chapter 17 

Describes the Operator/Message Services (OMS) package. 

Appendix A 

Describes the OPSER-based spooling package. 

Appendix B 

Lists the octal and decimal values of each bit in the PDP-11 word. 

Appendix C 

Lists the cluster size and total size of each disk that RSTS/E 
supports. 

Appendix D 

Lists the general RSTS/E messages that you may encounter when 
using RSTS/E. 

Appendix E 

Describes the SAVE/RESTORE system program for copying and 
backing up disks. 

Appendix F 

Describes the Device Testing package (DEVTST) used to verify the 
reliability of RSTS/E supported hardware. 


Related Documentation 

As system manager, you are responsible for setting certain parameters that 
affect the monitor and, consequently, the monitor directives. You also need to 
make decisions related to installing and updating your RSTS/E system. For more 
information on these topics, refer to: 

RSTS/E System Installation and Update Guide 

RSTS/E System Directives Manual 

RSTS/E Programming Manual 

For more information on RSTS/E documentation, consult the RSTS/E 
Documentation Directory . 

In addition to the RSTS/E documentation, you should have access to the following 
manuals: 

PDP-11 Peripherals Handbook 
DECnet/E System Manager’s Guide 


xx 






Conventions 


Symbols and other conventions represent keyboard characters or aid in the pre¬ 
sentation of information. This guide uses the following symbols and conventions: 


<RET> 

<LF> 

<Ctrl/X> 


U 


[] 



I 


color 


Represents a carriage-return/line-feed combination. Press the Return 
key on your keyboard to produce this combination. 

Represents a line-feed character. Press the Line Feed key on your 
keyboard to produce this character. 

Represents the Ctrl key and some other character, represented here 
by x. For example, enter <Ctrl/U> by holding down the Ctrl key and 
pressing the key labeled U. RSTS echoes or displays the character at 
your terminal as A U. 

Braces indicate a mandatory choice of one word from among two or 
more words. For example: 

/ACCESS={LOCAL I DIALUP) 

In this example, you must choose either LOCAL or DIALUP, but not 
both. 

Square brackets show the optional parts of a command in format 
statements. For example: 

DIRECTORY [file-spec[,...]] 

In this example, you can include one file specification ([file-spec]), or 
more than one ([,...]). Square brackets also indicate the choice you have 
in using a qualifier. For example: 

/[NOJDELETE 

This means you can enter either /DELETE or /NODELETE. 

When square brackets are shown enclosing a PPN, the brackets are a 
required part of the PPN syntax. 

A vertical bar indicates a choice. For example: 

/LOWERCASE=[INPUT I OUTPUT] 

means you can enter /LOWERCASE=INPUT or /LOWERCASE=OUTPUT. 

Red characters indicate information that you enter. In examples, black 
characters represent data produced by the computer. 


Summary of Technical Changes 

RSTS/E V10.0 has undergone many techinical changes. The following list outlines 
the major technical changes that apply to the RSTS/E System Manager's Guide 

• Hardware support for RA70 and RA90 disks and LA324 desktop printer 

• Command line editing and command recall 

• Host initiated LAT connections 

• Extended logical names 

• A new Operator/Message Services (OMS) package 

• LOGIN user names 

• Several new DCL commands and qualifiers particularly for host initiated LAT 
connections and for the BACKUP/RESTORE packabe 

• A new OPER privilege 
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Chapter 1 

Overview of RSTS/E System Management 


RSTS/E runs on a PDP-11 computer. It allows simultaneous, timeshared access 
to PDP-11 hardware and to RSTS/E software components through either local 
or remote asynchronous terminals. The RSTS /E Software Product Description, 
which is part of the RSTS/E media kit, describes the hardware and software 
RSTS/E supports. This guide describes the software a system manager uses to 
control the operation of a RSTS/E system. The following sections introduce some 
important RSTS/E concepts. 


1.1 Glossary of RSTS/E Terms 

To understand how RSTS/E works, you need to know these terms: 

CCL (Concise A concise way to run a RSTS/E system program. The CCL syntax 
Command lets you run a program without the RUN command and, unlike the 


Language) 

RUN command, lets you place the entire command on one line. After 
the program completes executing, control returns to your job key¬ 
board monitor. The system manager chooses the CCL commands for 
a particular RSTS/E system. In DCL, CCUs are defined using the 
DEFINE/COMMAND/SYSTEM command (see Chapter 12). 

DCL (Digital 

Command 

Language) 

A set of commands available on many different Digital systems. These 
commands perform basic tasks like copying and printing files, and 
running programs. On RSTS/E, the DCL run-time system manages the 
DCL command environment. See the RSTS/E System User’s Guide 
for more information about DCL on RSTS/E. See the RSTS/E Quick 
Reference Guide for a complete list of all DCL commands available on 
RSTS/E. 

Default 

Keyboard 

Monitor 

Job 

The main keyboard monitor on a RSTS/E system. You enter the default 
keyboard monitor (DCL) after you log in. 

The unit that RSTS/E uses to keep track of you (and other users) 
during a terminal session. When you log in, the system creates a job 
for you and assigns it a job number. The system uses your job number 
to keep track of everything you do from the beginning to the end of 
your terminal session. 

Job Keyboard 
Monitor 

The keyboard monitor that manages a job. The job keyboard monitor is 
the same as the default keyboard monitor, unless you decide to change 
it with the SET JOB/KEYBOARD command. After you change the job 
keyboard monitor, you remain under its control until you log out or use 
SET JOB/KEYBOARD again to change it. 
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Keyboard 

Monitor 


Monitor or 
Executive 


Operating 

System 


Program 

Development 

Public Structure 


The part of a run-time system that interprets keyboard commands. 
When working in the DCL environment, for example, you enter com¬ 
mands that the DCL keyboard monitor receives and interprets. Each 
RSTS/E keyboard monitor has an identifying prompt that it displays to 
indicate when it expects command input. Common keyboard monitor 
prompts on RSTS/E are: the DCL prompt ($) for DCL; "Ready" for 
BASIC-PLUS; angle bracket (>) for RSX; and period (.) for RT11. 

The master control system software that observes, supervises, controls, 
or verifies the operation of a computer system. Also, the collection 
of routines that controls the operation of user and system programs, 
schedules operations, allocates resources, and performs I/O. 

The collection of programs, including a monitor or executive and system 
programs, that organizes a central processor and peripheral devices 
into a working unit for the development and execution of application 
programs. 

The process of writing, entering, translating, and debugging source 
programs. 

The set of all disks that are public. When you do not include a device 
name in the file specification, the system by default accesses one of 
the disks on the public structure. The device name SY: represents the 
name for all disks in the public structure. Thus, if you do not have any 
public disks other than the system disk, SYO: and SY: are equivalents. 
If you have more than the system disk in the public structure, SY: 
refers to the aggregate of all public disks. SYO: refers to the system 
disk. 


Run-Time System software that manages part of the RSTS/E system. For exam- 

System pie, the BASIC-PLUS run-time system manages the BASIC-PLUS pro¬ 

gramming environment. The run-time system controls the interaction 
between a user or program and the monitor. 

System Disk The disk required by the RSTS/E monitor to start the system and to 
allow the system to run properly under timesharing. RSTS/E assigns 
device name SYO: to the system disk. 

System Program Any general-purpose program included in an operating system to 

perform common functions. CUSP is an acronym for Commonly Used 
System Program. 


1.2 System Management 

Management of RSTS/E begins with providing a properly tailored hardware 
and software configuration, proceeds through initializing the software at system 
installation time, and continues with the daily functioning of timesharing. Tb 
perform these steps efficiently, you should be familiar with timesharing concepts 
and practices or have a close working relationship with a senior programmer or 
analyst experienced with timesharing systems. 

Tb manage a system well, you should know the processing requirements of the 
system and its capabilities and structure. Information in the RSTS/E System 
Installation and Update Guide describes important aspects of hardware and 
software options and provides memory requirements to assist in configuring a 
RSTS/E system. * 

As the system manager, you should be particularly careful about initializing your 
system for the first time. Because there are so many variables, no prepackaged 
approach can give you a completely optimized RSTS/E system. The RSTS/E 
System Installation and Update Guide provides detailed information about all the 
initialization options. 
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To make sure that important information reaches the right persons within your 
organization, you should make someone responsible for current documentation 
of the system. This responsibility includes both locally generated and Digital- 
supplied procedures and guides. The responsible person should make sure that 
specified members of the staff receive the most current system information. In 
too many cases, improper use of resources occurs when responsible individuals do 
not have the latest information. 


1.3 Disk Organization 

System managers should understand that the organization of files on disks is 
important. Only with this knowledge can managers make the best use of all 
system resources. The following section introduces the concepts of disk and file 
structures and how to use them to your best advantage. 


1.3.1 Types of Disks 

RSTS/E supports two types of disks as part of its logical disk structure: private 
and public. The public disk structure consists of a system disk (the one that was 
booted and contains the RSTS/E monitor) and additional public disk packs or disk 
cartridges. The system disk must be physically on line and logically mounted 
whenever the system is running; this way, users can gain access to the system 
disk during timesharing operations. All other public disks that users may need to 
access must be physically on line and logically mounted. 

The system disk contains: 

• Monitor code 

• Initialization code 

• The default keyboard monitor 

• The command files for system startup and crash recovery 

Some installations may also use the system disk for storing active user jobs that 
are temporarily swapped out of memory. 

Remaining space on the public disk structure is used for: 

• Auxiliary run-time systems 

• Optional system files 

• System programs 

• User programs and data files 

You can use disk drives not devoted to the public structure for private disk 
packs or disk cartridges. Unlike public disks, you can logically and physically 
dismount and move private disks to other drives during timesharing operations. 
In addition, private disks make it possible to restrict disk storage to a defined 
set of users, which can be a distinct advantage when numerous projects are in 
progress. The file structure of a private disk is the same as that of a public disk. 

In addition to private and public disks, both of which any job on the system can 
share and access, you can logically mount a disk for use by only one job. In this 
case, only that job can access the disk. When the job terminates (for example, by 
logging out), the disk is logically dismounted. See "MOUNT Command for Disks" 
in Chapter 15. 


Overview of RSTS/E System Management 1-3 










1.3.2 File Structures 


The RSTS/E file structures let the monitor access system and user data in an 
organized way. RSTS/E currently supports three kinds of file structures: 

• Level 0.0 — is for RSTS/E disks created before V8.0. You can mount disks 
with this structure as read-only, private disks. You cannot mount them as 
system or public disks. 

• Level 1.1 — is the structure created for V8.0. You can mount disks with this 
structure as read/write, private disks. You cannot mount them as system or 
public disks. 

• Level 1.2 — is the structure created for V9.0 and later. You can mount disks 
with this structure as read/write, system, public, or private disks. 

NOTE 

If you are upgrading a single disk RSTS/E system to V9.0, you can 
mount a Level 0.0 or Level 1.1 disk as the system disk. See the section 
"Converting Disk Structures." 

If you have a RSTS/E V9 system with all new disks, you can skip the sections that 
describe the disk structures before V9. Furthermore, if you have pre-V9 disks, 
Digital recommends that you use the new DSKCVT disk conversion program 
to convert them to the latest disk structure. (See the section "Converting Disk 
Structures (DSKCVT)" later in this chapter). 

To see which structure applies to disks on your system, type SHOW DISKS 
as shown. The "Level" column indicates the RSTS/E disk structure level. For 
example: 

$ SHOW DISKS <RET> 


Disk Structure: 


Dsk 

Open 

Size 

Free 

Clu 

Err 

Name 

Level 

Comments 


DR1 

66 

131648 

29424 

22% 

4 

0 

BOWER 

1.2 

Pub, 

DLW 


DR2 

0 

242576 

33040 

13% 

8 

0 

CRONIN 

0.0 

Pri, 

R-O, 

DLW 

DR3 

33 

500352 

57744 

11% 

8 

0 

WOJTAS 

1.1 

Pri, 

DLW 


DR4 

0 

242572 

17528 

7% 

4 

0 

MODNE 

1.2 

Pri, 

DLW 


DR5 

0 

500352 

76152 

15% 

8 

0 

HOGAN 

0.0 

Pri, 

R-O, 

DLW 


$ 
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1.3.3 Level 0 Disk Structure (Pre-V8.0) 

Pre-V8.0 users gained access to files on a RSTS/E system by a Master File 
Directory (MFD) and by User File Directories (UFDs). Figure 1-1 shows these 
structures. 

Figure 1-1: MFDs and UFDs in Level 0 File Structure 
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As Figure 1—1 shows, each disk initialized for use on a RSTS/E system contains 
an MFD, located in [1,1]. The system uses the MFD to catalogue other accounts 
on the disk. The MFD on the system disk lists the accounts that can be used to 
log in to the system. On a private disk, the MFD contains entries of accounts 
that can create files on that disk. Any user can access any file on any disk if the 
protection code of the file permits. Only users whose accounts are entered in the 
MFD on a private disk can create files on that disk. 

The system creates one UFD for each user account on a disk when the manager 
sets up the account (or, optionally, when a user creates the first file for the 
account). The UFD catalogues all programs and data files under an account and 
maintains accounting and access information for these files. The UFD contains 
all retrieval information for the files because each file is pure data and has no 
linkage or structural information. 
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1.3.4 Level 1 Disk Structure (for V8.0 and V9.0) 

In V8.0 and V9.0, users access files on a RSTS/E system through the use of these 
structures: 

• Master File Directory (MFD) 

• Group File Directory (GFD) 

• User File Directory (UFD) 

Figure 1—2 shows how these structures are related. 

Figure 1-2: MFD, GFDs, and UFDs in the Level 1 File Structure 
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As Figure 1-2 shows, the MFD contains pointers to the Group File Directories 
(GFDs). The GFDs point to UFDs within each group. For example, a pointer in 
the MFD could access the GFD for files in [43,*] directories, from which it could 
access a specific UFD, such as [43,98], 
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1.3.5 Differences Between Level 0, Level 1.1, and Level 1.2 

The new disk structure (Level 1.2) differs from the previous disk structures (Level 
0 and Level 1.1) in the following ways: 

• The account data on Level 1.2 contains attribute blockettes for the new or 
expanded attributes such as quotas, multiple privileges, and long passwords. 

• The MFD on Level 1.1 and Level 1.2 is not associated with an account 
number. 

On Level 0, the MFD was located in [1,1], and had to be at Block #1. Now, 
Block #1 points to the location of the MFD, allowing the MFD to be placed 
anywhere on the disk. 

• The MFD and GFDs on Level 1.1 and Level 1.2 do not store files. 

On Level 0, the MFD could store files as well as point to accounts. 

• GFDs on Level 1.1 and Level 1.2 allow more direct access to accounts. 

On Level 0, the MFD contained a linked list of pointers to all the UFDs. 
UFDs were listed in the order in which they were created; the MFD was 
searched in sequence until it located a UFD. 

Now, the MFD contains direct pointers to GFDs, which in turn point directly 
to any UFD. (However, the structure of the UFDs remains the same as in 
Level 0.) Thus, DCL commands that display accounts (for example, SHOW 
ACCOUNT) list the accounts in ascending order, rather than in order of 
creation. 

• You can create up to 65,025 accounts with the Level 1.1 or Level 1.2 structure. 

With the Level 0 structure only 1735 accounts could be created and referenced 
on a disk. Now, you can create accounts for 255 groups, each with 256 users. 
Only the disk size restricts the number of accounts. 

These differences should not be noticeable to the users on your system. Level 1 
takes up a little more disk space. There are more pointers, because each group 
is handled separately, but access to files is faster and the system can have more 
accounts. The linked list structure of the MFD is replaced by direct access to 
GFDs. 


1.3.6 Converting Disk Structures (DSKCVT) 

The DSKCVT program performs the following functions: 

• Converts Level 0.0 disks to Level 1.2 

• Converts Level 1.1 disks to Level 1.2 

• Converts accounts with LOOKUP passwords to NOLOOKUP (optional) 

DSKCVT converts disks directly; you need no second disk to perform the conver¬ 
sion. Digital recommends that you first back up the data on any disks that are 
to be converted, so that any hardware or software errors that may occur during 
conversion will not cause loss of data. 

DSKCVT requires some work space if the pack being converted is Level 0.0 
format. Make sure there are 32 blocks times the number of different group 
numbers used on the pack. For example, if there are ten group numbers, the 
pack should have 320 blocks of free space for conversion. 
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DSKCVT accepts either a logically mounted or logically dismounted pack. 
However, any mounted pack should not be in use when you run DSKCVT. To 
make sure no one is using a mounted pack, DSKCVT dismounts and remounts it 
at the start of the conversion. 

In converting Level 1.1 disks to Level 1.2, DSKCVT adds several new attribute 
blocks to each account. Since some of the new attributes are only relevant to user 
accounts, DSKCVT asks the following: 

Convert accounts to NOUSER <no>? 

If you answer YES to this question (the default is NO), DSKCVT changes all 
accounts to nonuser accounts. Nonuser accounts have no passwords or privileges 
and can only serve to store files. 


CAUTION 

If you intend to move the accounts (via BACKUP and RESTORE) to 
the system disk from a disk you are converting with DSKCVT, then do 
not convert the accounts to NOUSER. Otherwise, you will not be able 
to log in to the accounts or create jobs in them. 

DSKCVT converts accounts to Level 1.2 by adding the following new attribute 
blocks to each account: 

• Disk quota/usage block 

• Privilege block 

• Nondisk block 

In creating the privilege attribute block, DSKCVT uses the following rules: 

• For account [1,1], it assigns all privileges except EXQTA 

• For all other [1,*] accounts, it assigns all privileges except SYSMOD and 
EXQTA 

• For accounts not in the [1,*] group, it assigns no privileges 

This scheme assigns privileges that are compatible with previous versions of 
RSTS/E. Once the conversion is complete, you can modify privileges as necessary 
using the SET ACCOUNT/PRIVILEGE command. For example, if you want all 
users to be able to change their passwords, enter the following: 

$ SET ACCOUNT/PRIVILEGE=SETPAS [*,*] 

DSKCVT sets the quota values as follows: 

• Logged-Out Disk Quota: Quotas of 0 (unlimited in V8.0 and earlier) are 
changed to -1 (unlimited in V9.0 and higher). Other values are retained. 

• Logged-In Disk Quota: Set to unlimited. 

• Job Quota: Set to unlimited. 

• Detached Job Quota: Set to unlimited for accounts [1,*], zero for others. 

• RIB Quota: Set to unlimited for accounts [1,*], 3 for others. 

• Message Quota: Set to unlimited for accounts [1,*], 12 for others. 

These values are compatible with V8.0. Again, you can use the SET ACCOUNT 
command to change them as needed. 
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The account flags are set as follows: 

• NOEXPIRE (If the account password was ??????, the account is marked 
EXPIRED.) 

• NOCAPTIVE 

• INTERACTIVE 

• DIALUP 

• NETWORK 

• PASS WORD_PROMPT 

• LOOKUP or NOLOOKUP (according to what you specified) 

NOTE 

Accounts with any ?s in their passwords convert properly but cannot be 
logged in to, since ? is an invalid character in V9.0 and higher. This is 
compatible with the meaning of ? in passwords in versions previous to 
V9.0. 

When converting a disk, you can decide whether to convert all account pass¬ 
words to their hashed form (NOLOOKUP) or leave them in their readable form 
(LOOKUP). If your site still uses applications that must look up passwords, do not 
hash passwords on the converted disk. (When you no longer need LOOKUP pass¬ 
words, you can use DSKCVT to convert all account passwords to NOLOOKUP on 
an existing Level 1.2 disk.) 

If you convert all accounts to NOUSER accounts, then DSKCVT will not create a 
password, privilege, or nondisk quota block for all accounts on the disk. 

You need all privileges to run DSKCVT. DSKCVT displays an error and aborts if 
you do not have all privileges currently enabled. There are two ways to obtain all 
privileges in order to use DSKCVT: 

• Log in to an account that has all privileges. Such an account has all the 
power and capabilities of the [1,1] account in V8.0, including the ability to 
poke memory (SYSMOD privilege). 

• During system startup, answer NO to the Proceed with system startup? 
prompt. You will be running in a job that has all privileges after you are 
returned to the DCL prompt. You can then run the DSKCVT program to 
convert disks as necessary. Once you have finished using DSKCVT, you can 
resume system startup by typing the following command: 

$ @[0,1]START 

Using this method, you do not need an account on your system that has 
all privileges. Whenever you need to perform an operation that requires a 
privilege not assigned to any account, you can do so by interrupting the initial 
system startup procedure. 

The following is an example of the DSKCVT program: 

$ RUN AUXLIB$:DSKCVT 
DSKCVT V10.0-A RSTS V10.0 

Disk to convert? DU2: 

** CURRENT DISK ATTRIBUTES ** 

Disk: _DU2: 

Label: WORK 

Level: 1.1 
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Convert accounts to NOUSER <N0>? 
Convert passwords to NOLOOKUP <YES>? 
Display accounts <YES>? 

Proceed (YES or NO)? Y 


Converting 

disk 

___DU2: to level 1.2 ... 

Account [ 

0,1 

] converted 

Account [ 

1,1 

] converted 

Account [ 

1,2 

] converted 

Converting 

disk 

__DU2: passwords to NOLOOKUP ... 

Account [ 

0,1 

] is a NOUSER account 

Account [ 

1,1 

] is a NOUSER account 

Account [ 

1,2 

] is a NOUSER account 


Disk _DU2: conversion completed on 19-Apr-90 at 11:04 AM 

In the example, DU2: is the disk pack to convert to Level 1.2. When you type 
DU2: in response to the prompt, DSKCVT displays the pack ID DU2:WORK. This 
lets you verify that you are converting the right pack. If the pack was already 
converted, DSKCVT displays an error message and then repeats the Disk to 
convert: prompt. Otherwise, DSKCVT goes on with the dialogue. 

When you answer YES to the Proceed (YES or NO)? prompt, DSKCVT begins 
the conversion. DSKCVT processes the accounts in ascending order. When the 
pack is converted, DSKCVT dismounts it and updates the pack label. The pack 
is now in Level 1.2 format. However, the storage allocation table (SAT) does not 
yet reflect the free disk space on the pack. Therefore, the system marks the pack 
"dirty" until DSKCVT updates the SAT. Then the system updates the pack label 
to show that the pack is now rebuilt. If the pack was mounted when DSKCVT 
started, the system mounts it once again, with the pack ID as its logical name. 

DSKCVT will not lose data even if the program aborts because of lack of work 
space, a system crash, or a disk hardware problem. If there is a problem during 
the conversion, you need only correct the problem and rerun the conversion. In 
such a case, you do not need to restore the pack from a backup pack. 

If the conversion proceeded far enough that DSKCVT was able to convert the 
pack, you only need to mount it. Otherwise, DSKCVT restarts the conversion 
from the beginning, after deleting the work files left over from the first attempt 
at conversion. 

When you convert a Level 0.0 (pre-V8.0) disk, DSKCVT makes two passes. In the 
first pass, DSKCVT converts the Level 0.0 pack to Level 1.1. The second pass 
converts the Level 1.1 pack to Level 1.2. 


1.3.7 Disk Optimization 

When a user tries to access a file on the public structure, the system searches the 
directories on all disks that are part of the public structure. The search verifies 
whether the file exists. You can avoid the overhead of searching more than one 
disk by placing frequently accessed files on a private disk. This technique is 
valid for systems with a number of disks in the public structure, as well as for a 
system whose public structure consists of only one disk. The ability to place and 
preextend directories can also help you optimize disks (see Chapter 7). 
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It is sometimes an advantage to dedicate an entire private disk to a single large 
production file. Such organization ensures an efficient directory structure and 
minimizes overhead to access file data. When more than one file is on the same 
private disk, it is best to dedicate a whole account to each production file. The 
system then spends less time searching the directory for file information. 

In general, you should keep volatile files and stable files in separate accounts to 
avoid fragmentation. Where file entries in the directory are spread across the face 
of the disk rather than being confined to a few sequential blocks, fragmentation 
requires the disk head to move more than is optimally efficient. Preextending 
directories can ensure that the directory is in sequential blocks (see Chapter 7). 
REORDR can restructure the directories on your system to improve disk access 
time (see Chapter 11). You can also optimize disk usage by separating frequently 
accessed files from those you use less often. 

In an environment where distinct data files must be accessed by the same 
program, the optimal organization is to keep each file on a different private 
disk. If a program must access more than one file on the same disk, overhead is 
increased because of disk-head movement. A large percentage of time is spent, 
therefore, in moving the head back and forth. However, if each file referenced 
by the program exists on a distinct private disk, head movement is not required 
whenever a program references another file. Head movement is restricted to 
locating the data itself. Positioning of directories can also help reduce head 
movement (see the CREATE/ACCOUNT command in Chapter 7). 


1.4 System Operation Concepts 

Immediately after logging in to the system, a user’s terminal is under the control 
of DCL (the system’s default keyboard monitor). The terminal is said to be at the 
system command level because you can type a system command and the keyboard 
monitor processes it accordingly. The terminal returns to the system command 
level when a command or program completes executing, or when you enter a 
Ctrl/C at the terminal. When the terminal is at the system command level, the 
keyboard monitor examines each ASCII text line entered and determines whether 
or not that line is a system command. System commands are executed upon 
entry as described in the RSTS/E System User s Guide. 

The user job area is initialized at login time and set to a size of at least IK words 
(K = 1024). The job area can grow in increments of IK words to a maximum 
size set by the system manager. The maximum size for any job image, including 
memory used by the current run-time system of the job, is 66K words. This is the 
maximum size that the PDP-11 Instruction and Data (I&D) architecture (PDP- 
11/44,45,50,53,55,70,73,83,84) allows. For a PDP-11 without I&D architecture 
(PDP-11/23+,24,34,35,40,60) the maximum size is 34K words. 

Under the RSTS/E system, jobs rim one at a time. A job runs until it enters an 
Input/Output (I/O) wait state or until it exhausts the time quantum assigned to it 
either by the system or the system manager. When the current job stops running, 
the scheduler runs the next job that is ready. Meanwhile, the interrupt-driven 
I/O device handlers are processing requested data transfers. After completing a 
transfer, the scheduler marks the job that requested the transfer as ready to run 
again and continues it from the point at which execution stopped. 

RSTS/E tries to keep as many jobs in memory as possible. When a job requires 
more memory than is available, the system may move some jobs out of memory 
to temporary storage in one of up to four areas known as swap files. This 
operation is called swapping. By convention, these files are named SWAPO.SYS, 
SWAPl.SYS, SWAP.SYS, and SWAP3.SYS. When memory becomes available for 
a job stored in a swap file, it is swapped back into memory. Jobs waiting for 
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keyboard input and jobs waiting for device I/O completion are most likely stored 
in the swap files, while jobs currently running or involved in disk or magnetic 
tape data transfers are stored in memory. 

As the system processes each job, it maintains accounting information in memory 
for that job. When the job is logged off the system, the information is used to 
update the accounting information stored on the system disk for that account. 


1.5 Privilege 

You must have a way to prevent general access to activities that can damage 
the system. The multiple privileges feature gives you finite control over access 
to activities. You can limit user access to just those activities suitable to each 
job. Multiple privileges gives you a tool to enhance both system performance and 
security. 


1.6 Multiple Privileges 

The multiple privileges feature groups similar system functions into sets and 
defines a privilege to control access to each set of functions. A group of 35 
privileges govern the entire set of RSTS/E system functions. The privileges given 
to an account determine the range of functions available to that account. Some 
privileges apply to very specific functions, while others control functions within 
broader classes of system use (see Chapter 6). 


1.7 Classes of System Activities 

The following sections divide some computer activities into general classes of 
system functions and discuss the privileges that control them. They describe: 

• Account Management Activities 

• File Access Activities 


1.7.1 Account Management Activities 

One general class of system activity is account management. A user accesses a 
computer through an account. The individual account is a member of a group, 
which contains all other accounts with the same project number. The group, 
in turn, is a subset of a world, which contains all accounts on the system. 
Account management activities include creating and deleting accounts, as well as 
changing passwords, disk quotas, and expiration dates. The following privileges 
control account management: 

GACNT Group Account Management — Grants account management privileges 

within the user’s group. 

WACNT World Account Management — Grants account management privileges 

for all accounts. 

SETPAS Set Password — Allows changing one’s own password. 
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1.7.2 File Access Activities 


Another general class of system activity is file access. Users routinely access 
files. Some files are created by the user and reside in the individual’s account. 
Other files reside in the accounts of other users or in system accounts. File access 
activities include creating, deleting, renaming, reading, writing, and executing 
files. 

Both the protection code of the file and the privileges granted to the account can 
affect whether the system grants or denies file access. 

In the case where no privileges are granted to an account, protection codes control 
the types of operations that a user can perform on a file. The SET PROTECTION 
command (or the /PROTECTION qualifier in the RSTS/E file specification) passes 
a value to the system that sets bits in the protection code byte. Each bit specifies 
that the activity named by that bit is prohibited or allowed. 

Certain privileges also govern file access activities. Some privileges override 
protection codes completely. The following privileges grant a user the right to 
perform certain file access activities, regardless of protection codes: 

GREAT) Group Read — Read any file within the group. Also, execute any 

program within the group, if the program’s executable bit is set. 

WREAD World Read — Read any file on the system. Also, execute any program 

on the system, if the program’s executable bit is set. 

GWRITE Group Write — Create, delete, extend, modify, or rename any file 

within the group. 

WWRITE World Write — Create, delete, extend, modify, or rename any file on the 

system. 


NOTE 

In addition to WWRITE, you need SYSIO privilege to create, delete, 
extend, modify, or rename any file in group zero ([0,*]). 


1.8 Multiple Privilege Masks 

You assign a certain set of privileges to each account. The system stores this set 

of privileges in privilege masks. A privilege mask is a set of flag bits with one bit 

corresponding to each privilege. 

For each active job, RSTS/E keeps three masks: 

• Authorized mask — The set of privileges that you give to the account. Users 
can use the SHOW ACCOUNT/FULL command to list the set of privileges 
available to their own account. 

• Current mask — The set of privileges now in effect for the job. The system 
always references this mask when it performs a privilege check. Users can 
raise or lower their privileges (up to their authorized limit) with the SET 
JOB/PRIVILEGE command. 

• Saved mask — The saved record of the current privileges when a job gains 
temporary privileges. (See the section "Temporary Privileges" in Chapter 6.) 
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When a user attempts to perform an activity that is restricted by one or more 
privileges, the system performs a privilege check. It examines the current mask 
to determine if the requesting job has all the privileges required to perform the 
activity. If the requesting job has insufficient privilege to perform the activity, the 
system returns one of the following errors: 

• ?Protection violation 

• ?IllegalSYS() usage 

• ?XXXX privilege required 
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Chapter 2 


Starting, Halting, and Automatic Recovery of 

RSTS/E 


This chapter describes how to start and halt a RSTS/E system and how the 
system recovers automatically from catastrophic system errors. This chapter 
also describes how to create the startup conditions for a RSTS/E system. See 
the RSTS/E System Installation and Update Guide for a description of all other 
initialization code options and their functions. 


2.1 Starting up RSTS/E 

To start a RSTS/E system, you must first load into memory a program containing 
the initialization code (INIT.SYS) and then answer YES to the Start timesharing? 
<YES> prompt. 

INIT.SYS is a large, standalone program that, once you transfer it from the 
RSTS/E distribution kit, exists on the system disk. INIT.SYS can provide a 
number of important system functions, such as: 

• Creating the RSTS/E file structure 

• Creating system files 

• Installing a RSTS/E monitor 

• Setting system defaults 

• Creating startup conditions for RSTS/E 

INIT.SYS does some of these functions automatically; however, they can also be 
done through the Option: prompt. 

Before you can use the initialization code to start your RSTS/E system, you must 
move the code into memory. This is called bootstrapping. 


2.1.1 Bootstrapping RSTS/E with a Hardware Bootstrap Loader 

The procedures for bootstrapping RSTS/E depend on the type of hardware 
bootstrap loader and the type of disk you use as the system device. You should 
make sure the following is done: 

• The system disk is physically mounted on a disk drive. 

• The drive on which the system disk is mounted has the READY light on and 
is in the WRITE ENABLE condition. 
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• All required drives are running and READY. 

• The console terminal is on line. 

Read the RSTS/E System Installation and Update Guide for the proper instruc¬ 
tions on using the hardware bootstrap on your system. 

After you use the bootstrap to load the initialization code, INIT.SYS marks the 
successful completion of the bootstrap procedure by printing an identification line 
that includes the RSTS/E version number, the installation name, the disk drive 
bootstrapped, and the INIT version number, followed by the Current date prompt. 
Enter the date and press Return. INIT displays the Current time prompt. Enter 
the time and press Return. INIT displays the Start timesharing prompt. For 
example: 

RSTS V10.0 installation-name (DMO) INIT V10.0 

Current date <DD-MMM-YY>? 15-Jul-90<RET> 

Current time <HH:MM AM/PM>? 8:15 AM<RET> 

Start timesharing? <Yes> 

If the program does not print this information, make sure the console terminal 
is on line and try the operation again. If the system prints an error message on 
the console terminal, see the RSTS/E System Installation and Update Guide for 
recovery procedures. 

If you want to enable the automatic restart facility, set the Central Processing 
Unit (CPU) switch register so bit 0 is ON. The automatic facility remains enabled 
as long as the CPU switch register remains set in this way. If your CPU does not 
have a switch register, the automatic restart facility is always enabled. 


2-1.2 Bootstrapping RSTS/E after a System Halt 

When a RSTS/E system halts as a result of a catastrophic error, RSTS/E displays 
the halt address in the address lights. For central processors that do not 
have console lights, for example the 11/23+, the 11/44, and CPUs with Remote 
Diagnostic Consoles (RDCs), the system prints the address on the console 
terminal. It is essential that you record this address. The exact procedure for 
examining memory locations depends on the type of processor and front panel of 
your system. Your Digital Software Specialist can describe the procedure for your 
system. Once you record this information, bootstrap your system again using the 
procedures described in the previous section. See the section ’’Automatic Recovery 
and Restart Facilities" for a description of catastrophic errors, system crashes, 
and crash dumps. 


2.1.3 Starting Timesharing 

After you bootstrap the system disk, RSTS/E loads the initialization code 
(INIT.SYS) into memory. INIT then prints an identification line followed by 
the Start timesharing? <Yes> prompt on the console terminal. You can answer in 
one of the following ways: 

• Type YES or press Return to start the monitor named in the INIT logo. 

• Type START and press Return to start the monitor named in the INIT logo 
and display a list of disabled devices. 
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• Type START monitor-name and press Return to start another monitor in [0,1] 
and display a list of disabled devices. 

• Type NO to have INIT return to the Option prompt. 

The program is ready to accept one of the options that Table 2—1 summarizes. 
See the RSTS/E System Installation and Update Guide for a complete 
summary of these options. 


Table 2-1: Initialization Option Summary 


Option 

Abbreviation 

Meaning 

BOOT dev 

BO 

Boots another device. 

DATE 

DA 

Resets the current date and time. Also, establishes 
default date and time formats. 

DEFAULT 

DE 

Establishes or changes a monitor's startup defaults 
such as memory usage. 

DSKINT 

DS 

Initializes and optionally formats a disk. It also 
checks for bad blocks. 

HARDWR 

HA 

Specifies device controller characteristics. 

HELP 

HE 

Prints the Help text. 

IDENT 

ID 

Prints INIT. SYS creation date and a list of patches 
for INIT. SYS and the installed monitor. 

PATCH 

PA 

Modifies RSTS/E system code to correct program 
errors and to add new program features. 

REFRESH 

RE 

Creates and positions system swap files, adds bad 
blocks to the bad block file, and positions optional 
system files on the system disk or any auxiliary 
disk. 

SAVRES 

SA 

Reconstructs (RESTORE), or makes an image copy 
(IMAGE) of a RSTS/E disk. 

START sil 

ST sil 

Installs the specified Save Image Library (SIL), 
assigns and checks defaults, and starts the RSTS/E 
system. If you do not enter a name for the SIL, 
INIT prompts you for one. 


2.2 Halting the RSTS/E System 

A system crash or setting the CPU console HALT/ENABLE switch to its HALT 
position causes a RSTS/E system to halt. For the PDP-11/45, 50, 55, and 70, 
RSTS/E considers the processor to be in a halt state if both RUN and PAUSE 
lights are off. For all other PDP-11 processors, RSTS/E considers the processor to 
be in a halt state if the RUN light alone is off. 

The SHUTUP program shuts down the RSTS/E system. During this operation, 
SHUTUP makes sure all files are properly closed and that system accounting in¬ 
formation is accurately updated. If you want to turn the power off, run SHUTUP, 
wait for INIT’s Start timesharing? prompt, and press the HALT/ENABLE switch. 
See the section "Performing System Shutdown: SHUTUP" in Chapter 4 for a 
complete description of the SHUTUP program. 
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Digital recommends that you do not halt RSTS/E during timesharing by moving 
the HALT/ENABLE switch on the CPU console to its HALT position. If you 
do this dining system shutdown, SHUTUP may not have completed clean¬ 
up operations; consequently, file data can become corrupted and accounting 
information may be lost. The only way to recover from such a halt and to salvage 
file information is to do the following: 

1. Raise the HALT/ENABLE switch back to its ENABLE position before you 
take any other action. 

2. Press the CONT switch to return the RSTS/E system to the state it was in 
before the halt. 


2.3 Automatic Recovery and Restart Facilities 

This section describes how catastrophic errors occur and how your system can 
automatically recover from them. This section also points out the need to include 
commands in the START.COM file to perform critical system operations when the 
system restarts in automatic mode. 


2.3.1 Catastrophic Errors and System Crashes 

Catastrophic errors and system crashes result from unexpected error traps. (For 
information on error traps, see the related processor handbook.) The processor 
can cause unexpected error traps when it: 

• Refers to a nonexistent or nonresponding memory address (for example, bus 
time-out trap) 

• Refers to an odd address with an instruction that requires a word address 

• Attempts to execute a reserved or nonexistent instruction 

Also, if the monitor detects a condition which it knows should not normally occur, 
the monitor can force a software crash. Catastrophic errors and system crashes 
may occur as a result of these types of problems: 

• Privileged job programming errors 

RSTS/E system software is designed to protect itself against programming 
errors occurring in nonprivileged jobs. When it detects such an error, the 
system aborts execution of the user request and returns a corresponding error 
message to the user’s program. 

RSTS/E software is vulnerable to some types of errors caused by jobs with 
certain privileges. The privileges that require special caution are SYSIO, 
SYSMOD, and WRTNFS. Even though most errors do not cause the system to 
crash, you should take special care when programming with privileged system 
function calls such as Poke memory SYS call (SYS -6). See the RSTS/E 
Programming Manual . 

• Hardware malfunctions 

Hardware malfunctions can cause the system to crash. If system crashes or 
catastrophic errors occur that you cannot explain (particularly on systems 
that have traditionally been functioning well), it is likely that a hardware 
problem has occurred. You can diagnose hardware problems by examining 
the output logged by the programs in the RSTS/E System Error Package. See 
Chapter 10 for information on error logging. 
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• System software malfunctions 

Although every attempt has been made to detect and eliminate system 
software errors, it is possible that RSTS/E software can crash unexpectedly. 
If a problem of this type is discovered (it should be reproducible in a defined 
environment and under defined conditions), contact a Digital Software 
Specialist. As problems of this type become known, Digital reports them in 
the "RSTS/E Software Dispatch" and corrects them as soon as possible. 


2.3.2 Automatic Recovery from Catastrophic Errors 

The system takes action in one of two ways when an unexpected error trap 
occurs: 

• A catastrophic error that affects only one user 

• A system crash for which some software or hardware problem may be 
responsible 

For a catastrophic error, the system determines which user was responsible for 
the error. It flags the user’s job with a special code; this causes the system to 
completely reinitialize that user’s job area when it is the user’s turn to run. The 
system prints an error message on the user’s terminal, followed by the text: 
??Program lost-sorry. The system resumes normal timesharing operations. 

NOTE 

Some run-time systems may issue other error messages. 

When the system detects a condition from which it cannot recover, it does the 
following: 

1. Writes an image of read/write memory and tables to the CRASH.SYS file. 

2. Bootstraps the system disk. 

3. Loads the initialization code into memory. 

4. Rebuilds the system disk. 

5. Executes an automatic restart. (This occurs if the CPU switch register has 
bit 0 set and if at least one minute has passed since startup.) 

If the CPU register does not have bit 0 set or if one minute has not passed since 
startup, the system does not perform an automatic restart. The system will 
only reboot; it will not restart. In other words, the automatic restart operation 
restarts timesharing using commands in the START.COM file. In contrast, a 
reboot merely loads the initialization code (INIT.SYS) into memory. INIT.SYS 
then prints its Start timesharing? <Yes> prompt, to which you can answer by 
typing any of the options in Table 2-1. 

If the system restarts automatically, it bootstraps itself into memory from the 
system disk. After the system is bootstrapped into memory, control passes to the 
initialization routines. The system recognizes startup was through an automatic 
restart rather than through normal startup. Consequently, the system initializes 
itself in automatic restart mode. 

If an error trap occurs within one minute of system startup or if two error traps 
occur within the same minute, the system halts at address 54. During automatic 
restart the system protects itself against an infinite loop of error traps and 
automatic restarts caused by a repeating hardware malfunction. 
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2.3.3 Automatic Restart Mode Initialization 

When the system is initialized in automatic restart mode, control bypasses all 
parts of the initialization code that call for operator intervention and initializes 
the system using parameters specified at previous startup. The system: 

1. Logs job 1 in to the system on KBO: under account [1,2] 

2. Invokes [0,1JSYSINI.COM 

3. Executes [0,1JSTART.COM with the PI argument set to ‘CRASH’ rather than 
‘START’ 

4. Performs specific operations appropriate for an automatic restart 


2.3.4 Restarting with a Different Monitor 

You can keep several different monitors on your system. When you start up 
timesharing, the system prompts you for your choice of monitor: 

Monitor name to start <default name>? 

You can also pre-set the choice of monitor so that the new monitor starts working 
at the next system shutdown and reboot. Use the SET SYSTEM/MONITOR_NAME 
command to do this. For example: 

$ SET SYSTEM/MON I TOR_NAME=ALTRNT 

This command causes the system to use the monitor stored in the file 
ALTRNT.SIL at the next automatic restart. ALTRNT.SIL also becomes the 
default name for the next time you start up timesharing manually. You need the 
SYSIO privilege to use the SET SYSTEM/MONITOR_NAME command. 

If you have the WREAD privilege and use the SHOW SYSTEM command, it 
displays the name of the monitor if it is different from the current monitor name. 


2.3.5 Restarting with a Different Swap Size 

If your system has I&D space, you set the maximum size of jobs when 
you install the system. You can change the maximum size with the SET 
SYSTEM/SWAP_MAXIMUM command. For example: 

$ SET SYSTEM/SWAP _MAXIMUM=4 0 

This command sets the maximum job size at 40K words. You can reset the 
maximum size to any value between 34K and 66K. The change in size does not 
take effect until the next time you start the system. You need the TUNE privilege 
to use the SET SYSTEM/SWAP_MAXIMUM command. 

If you have the TUNE privilege and use the SHOW SYSTEM command, it 
displays the new value of the swap maximum if it is different from the current 
swap maximum. 
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2.3.6 Power-Fail Hardware Used by RSTS/E 

When power fails, a PDP-11 processor traps through the vector at location 24. 
When power is restored, you can configure the system to do one of three things: 

• Halt. 

• Boot a specific device. 

If the hardware is configured to boot the system disk, INIT.SYS prints its 
identification line and the Start timesharing? <Yes> prompt and waits for you 
to enter one of the options from Table 2—1. 

• Trap again through the vector at location 24. 

In this case, the system must have core memory or battery backup. If memory 
contents are still valid (which means the battery backup is not exhausted), 
RSTS/E performs an automatic restart. 
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Chapter 3 

The System Startup Command Files 


This chapter describes how you control system startup with the system startup 
command file (START.COM). Startup occurs when you answer YES to the Start 
timesharing? <Yes> prompt, use the START option of the initialization code, or 
when the system restarts automatically. 

At startup, the monitor executes the command file [0,1]SYSINI.COM which 
in turn executes [0,1]START.COM. You can modify START.COM (but not 
SYSINI.COM) to suit the requirements of your installation. 

To control startup efficiently, you should understand the conditions at startup 
time: 

• Login attempts are prohibited (the monitor disables the login capability). 

• The monitor logically mounts only the system disk read/write. 

• No output is made to any terminal (except the console). 

• The monitor logs the console terminal KBO: into the system under the system 
library account [1,2]. 

• The monitor assigns ALL privileges to this initial job regardless of the 
privileges assigned to account [1,2]. 

• The monitor loads the DCL run-time system. 

• The monitor starts execution of the command file _SYO:[0,1]SYSINI.COM at 
the console. 


3.1 Creating and Using Command Files 

The SYSINI.COM command file contains commands necessary to initialize your 
RSTS/E system properly. Do not edit this file in any way; this command file is 
reserved by Digital and is replaced with every update of the system. 

The START.COM file that comes with the RSTS/E distribution kit is a sample 
only; it may not execute properly on your system without modification. Make 
sure START.COM includes the necessary commands to initialize your installation. 
Use a text editor on your system to modify the sample START.COM file supplied 
with the RSTS/E kit. 


NOTE 

Be sure both command files are in account [0,1] on the system disk. 
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The startup control file should perform the following operations: 

• Install monitor overlays 

• Install virtual disk 

• Mount public and private disks 

• Assign or replace systemwide logicals 

• Start error logging 

• Install auxiliary swap files 

• Enable caching and set default system characteristics 

• Install run-time systems and libraries 

• Start Operator/Message Services (OMS) package 

• Set terminal characteristics 

• Define system commands 

• Initialize virtual disk 

• Mount virtual disk 

• Create/assign LAT ports 

• Set printer characteristics 

• Start Print/Batch Services (PBS) package 

• Start OPSER-based spooling package (optional) 

• Start error analysis (ANALYS) if recovering from a crash 

• Start DECnet/E 

• Start LAT (optional) 

• Enable logins and log out the initial startup job 

The order in which the operations are performed is critical. For example, 
mounting all public disks ensures the integrity of the public structure by making 
available all files on the system. You can mount any private disks in a similar 
manner. The various steps tailor the system according to your installation's 
requirements. 


3.2 System Startup Command File: START.COM 

A complete system startup command file contains the required commands to 
perform initialization for timesharing and to perform routine operations. The 
following sample shows a startup command file: 

$ ! START.COM 
$ ! 

$ ! Copyright 1990 by 

$ ! Digital Equipment Corporation, Maynard, MA. 

$ ! 

$ ! 

$ ! PI “ Type of startup (either START or CRASH) 


3-2 The System Startup Command Files 






$ i *** Prompt to continue *** 

$ ! 

$ _if PI .eqs. "" then PI = ’’START” ! Default is START 
$ S = ’’system startup” 

$ _if PI .eqs. "CRASH" then S = "crash restart" 

$ GO = "" 

$ inquire/nopunc/exit=END/time_out=10 GO "Proceed with ''S'? <YES> " 

$ “if f$instr(1,"YES",f$edit(GO,-2)) .eq. 1 then _goto START 

$END: 

$ _exit 

$START: 

$ _open/logfile/replace 'Pl'.LOG 
$ _set noecho/warning 
$ _set verify 
$ _write 0 ’’" 

$ _write 0 " Beginning RSTS/E ''S'..." 

$ _set noon 

$ ! *** Install Monitor Overlays *** 

$ ! 

$ write 0 f$time()+ ** Installing monitor overlays" 

$ "run $UTLMGR.TSK 
!load/overlay ATTRIBUTE 
!load/overlay DCL 
!load/overlay DELETE_RENAME 
!load/overlay DIRECTORY 
!load/overlay FILE_UTILITY 
load/overlay SYSTEM__CALLS 
!load/overlay TERMINAL 
$ _eod 

$ ! *** Install Virtual Disk *** 

$ ! 

$ ! NOTE: There are commands later in this file to INIT and MOUNT the 
$ ! virtual disk, and install a CUSP on it. 

$ ! 

$ ! Comment out only ONE of the next two lines. That will control ALL 
$ ! virtual disk commands in this .COM file. 

$ ! 

$ ! VIRTUAL_DISK := YES 
$ VIRTUAL_DISK := NO 
$ ! 

$ _if VIRTUAL__DISK .eqs. "NO" then goto NOVDO 
$ _write 0 f$time()+ " Installing Virtual Disk" 

$ ^create/virtual 200 
$ ! Create a 200 block virtual disk 
$ ! This will use 50KW of memory 
$NOVDO: 

$ i *** Mount Disks *** 

$ ! 

$ R = ’”’ 

$ _if PI .eqs. "CRASH" then R = "and rebuilding " 

$ _write 0 f$time()+" Mounting ''R'disks" 

$ ! (If this is a crash recovery, MOUNT will rebuild 
$ ! the disks if necessary.) 

$ ! examples: 

$ ! $ mount/nowrite DR3:LIBRAR L: 

$ ! $ mount DB2:LOOKUP 

$ i *** Assign (or Replace) System-wide Logicals *** 

$ ! 

$ _write 0 f$time()+" Assigning logical names" 

$ ! examples: 

$ ! $ assign/system _SY:[2,9] FERN: 

$ ! $ assign/system/replace _DB2:[0,3] ERR0R$: 
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*** 


$ ! *** Start Error Logging 
$ ! 

$ _write 0 f$time()+ " Starting error logging" 
$ _set job/priority=0 

$ _if PI .nes. "CRASH" then __goto CONTI 
$ _run ERROR$:ERRINT 
100 
YES 

$ _E0D 

$ __goto C0NT2 
$CONTI: 

$ __run ERR0R$ :ERRINT 
100 
NO 

$ EOD 


$CONT2: 

$ _set job/priority=-8 

*** Install Auxiliary Swap Files *** 


If you have additional auxiliary swap files (SWAPO or SWAP3) to 
install, add them here. 

Note: SWAP1.SYS already installed if present, 
examples: 

$ _yrite 0 f$time()+ " Installing auxiliary swap files" 

$ _install/swapfile=0 _SY0:[0,1]SWAPO.SYS 
$ _install/swapfile=3 _SY0:[0,1]SWAP3.SYS 

*** Enable Caching and Set Default System Characteristics *** 

Setting system characteristics" 


write 0 f$time()+ " 

_run $UTLMGR.TSK 
set cache/file/enable/keep=15/clustersize=2 
set system/date__format=alphabetic 
set system/t ime_f ormat=am_j?m 
set system/label=dos 
set system/density=1600 
set system/name="RSTS/E V10.0" 
set system/powerfail_delay=300 
set system/hangup=delayed 

set system/password__prompt= (network, dialup) 
$ eod 


*** Install Run-time Systems and Libraries *** 

Note: Resident libraries CSP100 and CSPLIB are already installed. 

If you do not use CSPLIB for your own applications, then 
uncomment the "remove/library CSPLIB" command below. 

Installing run-time systems and libraries" 


$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ _write 0 f$time()+ 

$ _run $UTLMGR.TSK 
!remove/library CSPLIB 
install/runtime_system BASIC 
install/runtime_jsystem TEC0$:TECO 
install/library/noaddress=unrestricted EDT$:EDT 
install/library/address RMS$:RMSRES 
install/library/noaddress RMS$:RMSLBA 
install/library/noaddress RMS$:RMSLBB 
install/library/noaddress RMS$:RMSLBC 
install/library/noaddress RMS$:RMSLBD 
install/library/noaddress RMS$:RMSLBE 
install/library/noaddress RMS$:RMSLBF 
install/library/address RMS$:DAPRES 
$ EOD 
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*** 


$ i *** start Operator/Message Services 

$ ! 

$ OMS_ON := FALSE 
$ write 0 f$time()+ " Starting Operator/Message Services" 

$ Today = F$Left(F$CVTime(), 8) 

$ File = F$Left(Today, 2) + F$Mid(Today, 4, 2 ) + F$Right(Today, 7) 

$ _if F$Search("OMS$:REQLOG.OMS") .nes. "" Then - 
Rename/NoWarn OMS$:REQLOG.OMS 'File' 

$“ set terminal kbO:/permanent/operator=(messages,requests) 

! System console as an operator terminal 
$ start/operator/prio=0 
$ ! Start OMS package 

$ _if $STATUS then OMS_ON := TRUE 

$ i *** get Terminal Characteristics *** 

$ ! 

$ write 0 f$time()+ " Setting terminal characteristics" 

$ _load/overlay TERMINAL 
$ “run $TERMGR.TSK 

set terminal kbO:/permanent/device_type=LA34 
! System console as hard copy 

set terminal kbdO:/permanent/device_type=LA100 
! Pseudo-keyboard 0 for batch 

!set terminal kbf0:/permanent/noautobaud/speed=9600/device_type=VT100 
! DHO line 0 as VT100 at 9600 baud 

!set terminal kbgO:/permanent/noautobaud/speed=9600/device_type=VT100 

! DZO line 0 as VT100 at 9600 baud 

!set terminal kbg8:/permanent/noautobaud/speed=9600/device_type=VT240 
! DZ1 line 0 as VT240 at 9600 baud 


$ _EOD 

$ __unload/overlay TERMINAL 

$ j *** Define System Commands *** 

$ ! 

$ write 0 f$time()+ " Defining system commands" 
$ T Install system commands (CCLs) 


$ _run $UTLMGR.TSK 
define/command/system BCK- 
!define/command/system BPC-REF 
define/command/system BYE- 
define/command/system CNV- 
define/command/system DI-RECTORY 
define/command/system DEF- 
define/command/system DES- 
define/command/system DSP- 
define/command/system EDT- 
!define/command/system FIT- 
define/command/system IFL- 
define/command/system LBR- 
define/command/system LIBR- 
define/command/system LIN-K 
define/command/system MACR-0 
define/command/system MAC- 
!define/command/system MAK-E 
!define/command/system MU-NG 
define/command/system PAT- 
define/command/system PIP- 
define/command/system RST- 
define/command/system SW-ITCH 
define/command/system SY-STAT 
!define/command/system TE-CO 
define/command/system TKB- 


RMS$rRMSBCK.TSK 
AUXLIB$:BPCREF.TSK 
$LOGOUT.TSK 
RMS$:RMSCNV.TSK 
$DIRECT.TSK 
RMS$:RMSDEF.TSK 
RMS$:RMSDES.TSK 
RMS$:RMSDSP.TSK 
EDT$:EDT.TSK 
AUXLIB$:FIT.TSK 
RMS$:RMSIFL.TSK 
$LBR.TSK 
$LIBR.SAV 
$LINK.SAV 
$MACRO.SAV 
$MAC.TSK 
TECO$:TECO.TEC 
TECO$:TECO.TEC 
$PAT.TSK 
$PIP.SAV 
RMS$rRMSRST.TSK 
$SWITCH.TSK 
$SYSTAT.TSK 
TECO$:TECO.TEC 
$TKB.TSK 


/line_number=CCL 

/privilege 

/line number=CCL/privilege 


/line number=CCL/privilege 


/1ine_number=8208 
/1ine_number=8208 
/line_number=8216 

/line_number=3584 

/line_number=3584 

/line_number=8208/privilege 
/privilege 

/line_number=CCL/privilege 
/ line__number=CCL/pr ivilege 
/line number=3584 


$ EOD 
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$ ! *** Initializing Virtual Disk *** 

$ ! 

$ ! NOTE: Virtual disk must first be created. Do not edit the next line. 
$ _if VIRTUAL_DISK .eqs. "NO" then _goto N0VD1 
$ __write 0 f$time()+ M Initializing Virtual Disk" 

$ _set on ! make sure the on error goto is enabled 
$ _on error then goto N0VD1 
$ __run $dskint 
DVO: 

V 
1 
4 
1 

NO 

PRI 

NO 

NO 

YES 

NO 

NO 

0 

N 

Y 

$EOD 

$ ! *** Mount Virtual Disk, then set it up *** 

$ ! 

$ ! 

$ _set noon 

$ _mount DVO:V/PRIVATE 

$ _copy SY:[1,2]SYSTAT.TSK DVO:[0,1]/PROTECTION=232/CLUS=-l 

$ ! *** Delete and Re-define system commands for DVO: *** 

$ ! 

$ _delete/command/system SYSTAT 

$ _define/command/system SY-STAT DVO:[0,1]SYSTAT.* /PRIV/LINE NUMBER=CCL 

$ ! 

$ ! End of virtual disk commands 
$N0VD1: 


$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 

$ 


! *** Create/Assign LAT ports *** 

! If you have remote devices connected to a terminal server 
! which you want to host initiate connections to, then you 
! will want to create and assign the LAT ports here. Once 
! the port has been created you will also want to set the 
! characteristics of the device. 

! For example: 

! $ __write 0 f$time()+ 11 Creating and assigning LAT ports" 

! $ _create/port/lat/terminal_server=LAT890/remote_port=port_72 KBIO: 

! $ _create/port/lat/terminal_server=LAT890/service=ln03__printer KBI1 

! $ _set terminal/device_type=vt220/perm KBIO: 

! $ _set terminal/device_type=LN03/nointeractive/perm KBI1: 

! *** Set Printer Characteristics *** 

| 

_write 0 f$time()+ " Setting printer characteristics" 

! examples: 

! $ _set printer LPO:/device_type=LPll 

! $ _set printer LP1:/device_type=LA180 

! $ _set printer LP2:/device_type=LN01 
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$ ! *** Start Spoolers *** 

$ ! 

$ _write 0 f$time()+ " Starting spoolers” 

$ ! Start PBS spooling package 

$ _start/queue/manager 
$ ! 

$ ! ** OPTIONAL** Start OPSER (old) spooling package 

$ ! 

$ goto C0NT3 ! If OPSER is desired, delete this line. 

$ ! Install related system commands 

$ define/command/system PL-EASE OPSER$:PLEASE.TSK /privilege/line_number=CCL 

$ ~define/command/system QU-EUE OPSER$:QUE.TSK /privilege/line_number=CCL 

$ _run OPSER$:OPSER 

LOG OPSER$rOPSER.LOG;ALL 

CHA KBO: 

MESS ALL 
OPER KB*:[1,2] 

DETACH 

$ _run OPSER$:QUEMAN 

DETACH/PRI:O/RUN:6 

$ _set job/priority=-8 

$ _run OPSER$:SPOOL 

LPO:/HEAD:2/RUN:9/WIDTH:80 

$ _set job/priority=-8 

$ _run OPSER$-.SPOOL 

LP1: /HEAD : 1/RUN : 9/WIDTH: 132 

$ _set job/priority=-8 

$ __run OP SER$: BATCH 

BAO:/ERROR:FATAL/NOQUEUE/NODELETE 

$ _set job/priority=-8 

$ _run OPSER$:BATCH 

BA1:/ERROR:FATAL/NOQUEUE/NODELETE 

$ _EOD 

$CONT3: 

$ ! *** Start ANALYS if in Crash Recovery *** 

$ ! 

$ _if PI .nes. "CRASH" then _goto CONT4 
$ _write 0 f$time()+ " Starting analysis" 

$ _run ERROR$:ANALYS 
[0,1]CRASH.SYS 
ERROR$:ANALYS.DMP 
ERROR$:ERRORS.FIL/DET 
$ _EOD 

$C0NT4: 

$ I *** Starting DECnet/E V4.1 *** 

$ ! 

$! __write 0 f$time() + " Starting DECnet/E V4.1" 

$ ! First define the DECnet related CCL commands 

$! define/command/system NCP DECNET$:NCP.TSK/priv/line=ccl 
$! "define/command/system NFT DECNET$:NFT.TSK/priv/line=ccl 
$! _define/command/system NET DECNET$:NET.TSK/priv/line=ccl 
$! define/command/system TLK DECNET$:TLK.TSK/priv/line=ccl 
$ ! Now start the network 
$! ncp set system 
$! ncp set exec state on 
$! ncp set cir una-0 state on 

$ ! *** Start up LAT *** 

$ ! 

$! _write 0 f$time()+ " Starting LAT" 

$! _SET NODE/LAT/ENABLE=0 

$! _SET NODE/LAT/IDENTIFICATION="RSTS/E V10.0 LAT" 

$! CREATE/SERVICE/LAT RSTS/IDENTIFICATION="Unauthorized use prohibited" 

$! “START/LAT XEO: 
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*** 


$ i *** Enable Logins 
$ ! 

$ _set system/logins 
$ _broadcast/all "RSTS/E is on the air..." 

$ _if OMS_ON then _request/noreply "The ''S' is complete" 
$ __close/logfile 
$ __set noverify 
$ _set echo 
$ __logout/br 
$ exit 


NOTE 

The startup control files must be in [0,1] on the system disk (_SY0:, the 
disk that was bootstrapped). 


3.2.1 Install Monitor Overlays 

To improve system performance, you can make overlays resident in memory. All 
overlays supported by RSTS/E are listed. Remove the comment flag from the 
overlays you want to make resident. 


3.2.2 Install Virtual Disk 

If you want to use a virtual disk, remove the comment flag from the VIRTUAL^ 
DISK := YES entry and comment out the VIRTUAL_DISK := NO entry 


3.2.3 Mount Public and Private Disks 

To ensure the integrity of the public structure by making available all files on 
the system, you should mount all public disks. You can mount any private disks 
in a similar manner. If this is a restart from a system crash, MOUNT rebuilds 
the disks as required. See Chapter 15 for more information on mounting and 
initialization of disks. 


3.2.4 Assign or Replace Systemwide Logical Names 

You can assign a systemwide logical name to a specified device type, unit number, 
and PPN (optionally) with the ASSIGN/SYSTEM command. See Chapter 12 for 
more information on the use of systemwide logical names. 


3.2.5 Start Error Logging 

It is important that you run the ERRINT program on your system. This program 
sets initial conditions for system error logging and runs the ERRCPY program 
which transfers to a disk file all errors logged by the RSTS/E monitor. If ERRINT 
is the first program to be run (as Digital recommends), it will occupy job number 
1 on the system and thus be easily monitored. Chapter 10 describes ERRINT and 
ERRCPY. 

NOTE 

If your system has more than 256K words of memory, you should 
consider adding /LOCK to the first line after the RUN ERRINT 
command lines to keep ERRINT resident at all times. 
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3.2.6 Install Auxiliary Swap Files 

If you want to use swap files SWAPO.SYS or SWAP3.SYS, remove the comment 
flag from the appropriate entry. 


3.2.7 Enable Caching and Set Default System Characteristics 

The SET CACHE/FILE/ENABLE command enables caching of data files whose 
UFD entry or OPEN MODE specifies caching. The /KEEP qualifier lets you spec¬ 
ify the time that an unused cache cluster is kept in memory. The /CLUSTERSIZE 
qualifier controls the number of contiguous data blocks that are copied from the 
disk to the cache whenever file data is cached. For more information on data and 
directory caching, see the section ’’SET CACHE Command” in Chapter 11. 

The SET SYSTEM command sets the default system characteristics. In the 
sample START.COM, for example: 

• The date format is alphabetic 

• The time format is AM_PM 

• The magnetic tape label is DOS 

• The magnetic tape density is 1600 bpi 

• The system name is RSTS/E V10.0 

• The power fail delay is 300 seconds 

• The hangup mode is delayed 

• The system password prompt is displayed for network and dialup connections 
See Chapter 14 for more information on setting system default characteristics. 


3.2.8 Install Run-Time Systems and Libraries 

The INSTALL/RUNTIMEJ3YSTEM command installs auxiliary run-time sys¬ 
tems (like BASIC) in memory. See the section "Run-Time System Control” in 
Chapter 12 for more information. 

The INSTALL/LIBRARY command installs resident libraries (like RMSRES) in 
memory. See Chapter 12 for more information on resident library control. 


3.2.9 Start Operator/Message Services (OMS) Package 

The Operator/Message Service package (OMS) provides operator services for 
user requests and messages. The package is started with a single command. 
Chapter 17 contains detailed descriptions of the DCL commands you can use to 
manage operator/message services. 


3.2.10 Set Terminal Characteristics 

At startup time, the system sets the characteristics of all keyboard lines (except 
line number 0) to hardcopy, 80 column output at the line speed of 300 baud. 
Thus, you need to use the SET TERMINAL command to set the correct charac¬ 
teristics of your terminals. Chapter 8 contains detailed descriptions of the SET 
TERMINAL command qualifiers. 
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3.2.11 Define System Commands 

It is most convenient to define Concise Command Language (CCL) sys¬ 
tem commands on the system at the start of timesharing using the 
DEFINE/COMMAND/SYSTEM command. The abbreviations shown in the 
definitions of the CCL commands reflect the way the RSTS/E documentation 
describes the commands. As the system manager you can redefine the abbrevia¬ 
tions. You should not alter the fully defined command because each program is 
coded to recognize the fully expanded command. 

Note that the abbreviation point should be the same as the one used by DCL 
itself. For most DCL commands, the abbreviation point follows the second 
character, but for some, the abbreviation point follows the third or fourth 
character, to assure a unique abbreviation for each command. 

Use caution when you define system commands in this way. You may make 
features of other keyboard monitors unavailable. This may happen if, for 
example, you define PRINT as a CCL command. BASIC-PLUS users will then 
not be able to use the immediate mode PRINT statement. 

Two CCL commands duplicate commands the BASIC-PLUS keyboard monitor 
recognizes: HELLO and BYE. The commands are shown here to point out what 
BASIC-PLUS does by default. Other keyboard monitors may not recognize the 
commands HELLO and BYE if they do not exist as CCL commands. 

Each CCL definition requires one small buffer. The buffer will be allocated from 
the FIP small buffer pool. If this buffer pool is full, however, the monitor allocates 
the buffer for the CCL definition from the general buffer pool. See Chapter 12 for 
more information on the DEFINE/COMMAND/SYSTEM command. 


3.2.12 Initialize Virtual Disk 

The virtual disk is next initialized with the list of parameters. 


3.2.13 Mount Virtual Disk 

You can copy files that are read from or executed from applications to the virtual 
disk. If you copy application data files to the virtual disk, do not include files that 
are written to. 


3.2.14 Create/Assign LAT Ports 

If you want to use host initiated connections to remote devices connected to 
terminal servers, create and assign the LAT ports. Remove the comment flags 
and include your server and port names. 


3.2.15 Set Printer Characteristics 

Just as you did for terminals, you need to set the characteristics of your printers. 
Minimally, you need to specify the device type of each printer on your system. 
See Chapter 11 for more information about the qualifiers for the SET PRINTER 
command. 
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3.2.16 Start Print/Batch Services (PBS) Package 

The Print/Batch Services package (PBS) provides printing services for line 
printers or terminals, and batch processing. The package is started with a single 
command. Chapter 9 contains detailed descriptions of the DCL commands you 
can use to manage print/batch services. 


3.2.17 Start OPSER-Based Spooling Package (Optional) 

The OPSER-based spooling package, like PBS, provides print and batch services. 
RSTS/E offers this optional package for compatibility with previous versions 
of RSTS/E. New applications should use PBS. If you want to use the OPSER 
package, delete the goto CONT3 line. For more information on OPSER, see 
Appendix A of this manual and the RSTS/E Utilities Reference Manual. 


3.2.18 Start Error Analysis (ANALYS) if Recovering from a Crash 

Run the ANALYS program immediately after a system crash to recover valuable 
diagnostic information. See Chapter 10 for a description of the ANALYS program. 


3.2.19 Start DECnet/E 

If you are using DECnet/E, remove the comment flag from all lines. 


3.2.20 Start LAT 

The sample contains commands to enable LAT, but these are in the form of 
comments. If you want to enable LAT automatically on system startup, edit 
the [0,1JSTART.COM file and remove the exclamation points (!) from the LAT 
commands. 


3.2.21 Enable Logins and Log Out Initial Startup Job 

The SET SYSTEM/LOGINS command should appear after the commands that 
perform all required and routine operations. The SET SYSTEM/LOGINS com¬ 
mand lets users log in to the system. You can then notify users that timesharing 
has started. See Chapter 13 for more information on job management. 

You should always logout the initial startup job, since it runs with ALL privileges. 
Failing to do so can create a security risk if the system console is left unattended. 
The startup file automatically logs out the startup job. 


The System Startup Command Files 3-11 














r 











>** 

. 





r*-« 




•? 











Chapter 4 

Shutting Down the RSTS/E System 


4.1 Performing System Shutdown: SHUTUP 

The shutdown procedures for the RSTS/E system are critically important. If 
you are not careful in performing system shutdown, valuable user data can 
be irretrievably lost. To understand shutdown procedures fully, you need to 
understand other RSTS/E system procedures. Chapter 12 describes these 
concepts such as controlling logins, removing system files and resident libraries, 
sending messages to all logged-in users, and forcing commands to unresponsive 
terminals. 


4.1.1 Running SHUTUP 

You use the SHUTUP program to shut the system down in an orderly manner. 
SHUTUP is in the system library account $ ([1,2]). SHUTUP must be installed 
as a privileged program (protection code <232>). If not, the system displays the 
following error message: 

?Program must be privileged 

Tb run SHUTUP, you must have SHUTUP privilege. If you do not, the system 
displays the following error message: 

7SHUTUP privilege required 

SHUTUP can be run from any local terminal over a dialup line or over a LAT 
line. SHUTUP cannot be run from a pseudo keyboard (for example, by a SET 
HOST connection). 

Tb verify that conditions are suitable for shutting down the RSTS/E system, use 
any of the SHOW commands, such as: 

• SHOW JOBS 

• SHOW DISKS 

• SHOW DEVICES/ALLOCATED 

By executing these SHOW commands, you can determine what jobs are active on 
the system and what disks and other peripheral devices are in use. 
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4.2 SHUTUP Phases 


As SHUTUP runs, it proceeds through the following phases: 

1. Setup dialogue 

2. Warning message 

3. DECnet/E shutdown (if necessary) 

4. Initial job killing 

5. Print/Batch Services (PBS) shutdown (if necessary) 

6. OPSER (optional spooling package) shutdown (if necessary) 

7. Operator/Message Services (OMS) shutdown (if necessary) 

8. EVTLOG shutdown (if necessary) 

9. ERRCPY shutdown (if necessary) 

10. Final job killing (if necessary) 

11. EMT logging shutdown (if necessary) 

12. Unload and remove run-time systems and resident libraries 

13. Log file closing 

14. Swap file removal 

15. Disk dismount 

16. Final shutdown 

The following sections describe these phases, the operator interactions required, 
and the expected results of the shutdown operation. Possible results, which you 
may not expect are also described. Several sample runs of SHUTUP show the 
results of shutting down the system. 


4.2.1 Setup Dialogue Phase 

The set-up dialogue phase processes all questions relating to the selection of 
options in running SHUTUP. It also checks for the presence of PBS or OPSER. 

In response to questions that appear during this phase, you can press the 
circumflex ( A ) key to return to the previous question. Otherwise, you should 
terminate your responses by pressing the Return key. 

If the PBS package is present, SHUTUP prints the following message: 

Allow Print/Batch entries to complete <YES>? 

If you type NO, SHUTUP aborts all PBS entries that are in progress. If you press 
Return or type YES, SHUTUP lets all currently running PBS entries finish. 

If OPSER is present and running, SHUTUP prints the following question: 

Use OPSER for utilities shutdown <YES>? 
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SHUTUP operates in either of two modes: 

• Without OPSER: In this mode, regardless of whether OPSER is running, the 
SHUTUP program treats all jobs in the system alike during the shutdown 
procedure (except itself, the Print/Batch Services program, the DECnet/E 
EVTLOG program, the EMT logger program, and ERRCPY). 

• With OPSER: In this mode, SHUTUP allows OPSER to shut down its con¬ 
trolled jobs before SHUTUP continues with the regular shutdown procedures. 

You should be familiar with the OPSER program and how it controls various 
utility programs (such as QUMRUN and the OPSER spooling package programs). 

Press Return or type YES to have SHUTUP communicate with OPSER during 
the shutdown procedures. If you type NO, SHUTUP prints another question to 
confirm your response: 

Are you sure you don't want to use OPSER <NO>? 

Pressing Return or typing NO causes the program to repeat the previous question 
so you can again decide to use or not to use OPSER during shut down. Otherwise, 
the program ignores OPSER during the shutdown procedures. 

If you choose to use the OPSER program, SHUTUP prints the following additional 
question: 

Allow utilities to reach logical end point <YES>? 

If you press Return or type YES, the program directs OPSER to tell its online 
jobs to shut down their operations at the next logical breakpoint in their job 
streams. For a line printer spooler, for example, this breakpoint occurs between 
queued jobs. 

If you type NO, the program directs OPSER to tell its online jobs to abort and 
stop operations immediately. You should abort in this way only in an emergency: 
jobs being processed at the time of shutdown may be lost unless you have 
previously halted queuing and spooling operations and requeued these jobs. 

SHUTUP then asks you to specify the number of minutes you want to elapse 
before shutdown occurs: 

Minutes until system shutdown (0-99) <5>? 

This waiting period is called the "warning message phase" and may be as short 
as 0 minutes or as long as 99 minutes. Press Return to select the default value 
of 5 minutes. If you decide to bring the system down immediately by typing 0, 
SHUTUP does not ask the two questions about disabling logins and the DECnet/E 
network. 

When you specify a shutdown period greater than 0 minutes, SHUTUP allows you 
to select the amount of time that will elapse before further logins are disabled: 

Minutes until logins are disabled (0-99) <0>? 

This question gives you the opportunity to select the amount of time during which 
users can continue to log in to the system as shutdown occurs. Users can log in to 
the system (as if the system were not shutting down) for the number of minutes 
you specify. The ability to allow users this flexibility is useful when you specify a 
long shutdown period. 

There will be times when you do not want to allow any more users on the system. 
In this case, accept the default response by pressing Return. Then, users can no 
longer log in to the system; however, those already logged in remain unaffected. 


Shutting Down the RSTS/E System 4-3 





NOTE 

SHUTUP disables all logins at least one minute before the initial job 
killing phase. 

The last message in the set-up dialogue phase allows you to choose the number of 
minutes that will elapse before new network activity is disabled: 

Minutes until new network activity is disabled (0-99) <nn>? 

The number of minutes SHUTUP selects for the default value <nn> depends on 
your response to the system shutdown question. As in the previous question, 
being able to specify when the network will shut down allows users time to 
complete network tasks. If you choose to allow no further logical links to be 
created, type 0, and then press Return. Those still using the network can 
continue to work but no new users are allowed access to the network. 

Shutdown with automatic RESTART <NO>? 

If you type YES, you will automatically restart the system after the shutdown. 
The system does not restart from the terminal you are using. INIT.SYS uses the 
console terminal (KBO:), no matter what terminal you use for SHUTUP. You must 
determine whether INIT.SYS failed to start by looking at the console terminal. 

Use automatic restart to change the monitor name, the swap maximum, LAT 
support, or the maximum number of pseudo keyboards. 


4.2.2 Warning Message Phase 

At the beginning of the warning message phase, as well as in the beginning of 
all other phases that SHUTUP may execute, a message appears on the system 
console terminal (KBO:) in the following format: 

hh:mm AM dd-mmm-yy ######## <phase title> ######## 

PM 

SHUTUP prints: 

• The time that it issues the message in the format hh:mm {AM I PM} 

• The date that it issues the message in the format dd-mmm-yy 

• The title of the current phase 

SHUTUP prints the following message on the system console terminal when the 
time specified for disabling logins has elapsed: 

Further LOGINS are now disabled 

The RSTS/E shutdown procedure requires that logins are disabled before the 
monitor can perform the final shutdown operation. During the following phases, 
SHUTUP continuously checks that logins remain disabled. If, for any reason, 
logins are not disabled, SHUTUP immediately aborts all operations with the 
following message: 

?Logins not disabled 

??SHUTUP aborting - please try again later 

You should determine the cause of the change, correct the problem, and run 
SHUTUP again. 

If your system has DECnet/E support, the SHUTUP program prints the following 
message when the time specified for disabling network activity expires: 

Further network activity is now disabled 
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The message tells you that no new logical links can be formed. Those links 
that are already active, however, can remain active until the time to network 
shutdown has elapsed. Before the network shuts down, the DECnet/E program 
EVTLOG may print messages indicating the status of the network. The initial 
EVTLOG message marks the beginning of the network shutdown phase. The 
second message, issued later in the shutdown process, indicates that the network 
has been shut off completely. See the section "SHUTUP Example: DECnet/E 
Shutdown" for an example of these messages. 

During the warning message phase, the program issues warning messages indi¬ 
cating the system is shutting down. These messages appear on most keyboards 
in the system, including pseudo keyboards. The following keyboards are the 
exceptions: 

OSC - The OPSER operator services console 
KBn: - The terminal running SHUTUP 

The program issues warnings after an appropriate waiting period, defined by the 
following formula: 

waiting time = (total time left)/5 + 1 minutes 

For an initial waiting period of 60 minutes, warning messages appear at 60, 

47, 37, 29, 23, 18, 14, 11, 8, 6, 4, 3, 2, and 1 minute before shutdown begins. 
SHUTUP prints the following message on all system terminals at each warning 
time: 

hh:mm AM dd-mmm-yy System going down in n minutes, please finish up 
PM 

At the same time, the following message appears on the terminal running 
SHUTUP: 

n minute message sent 

When the time to shutdown has expired or if the initial waiting period is specified 
as 0, the final warning message appears: 

hh:mm AM dd-mmm--yy **** FINAL WARNING! ! ! ! ! System shutting down **** 

PM 

At this point, the program enters the next phase. SHUTUP prints the time and 
date for both the SYSTEM GOING DOWN and the FINAL WARNING messages. 


4,2,3 DECnet/E Shutdown Phase (When Necessary) 

The time to DECnet/E shutdown begins as soon as you enter the number of 
minutes that should elapse before new network activity is disabled: 

Minutes until new network activity is disabled (0-99) <nn>? 

The number of minutes, shown in angle brackets <nn>, is the default response. 

It assumes the same value you typed in response to the SHUTUP question: 

Minutes until system shutdown (0-99) <nn>? 

Rather than accept the default response (that is, to the network activity question) 
and have new network activity disabled at the same time the system shuts 
down, it is often better to disable new network activity before shutdown occurs. 
Entering a value less than the number of minutes to shutdown establishes a 
period before shutdown in which no new links can be created; it also allows time 
for those already active to complete network tasks. If you want new network 
activity disabled immediately, type 0 and press Return. When the time to disable 
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network activity has elapsed (0 to 99 minutes), SHUTUP prints a message to 
indicate no further network activity is allowed: 

Further network activity disabled 

SHUTUP disables new network activity by executing the equivalent of the 
Network Control Program (NCP) command SET EXECUTOR STATE SHUT. 

This prevents the creation of new logical links but does not affect existing logical 
links. In reality, a user can create new network links until the network activity is 
disabled. After that period ends, no new links can be created, but users already 
on the network can continue working until the system shuts down. The network 
remains up until there are no links active or until the system shuts down. 

As soon as all logical links have been disconnected by their users, the network 
state changes automatically to OFF. The state is immediately set to OFF if 
no links existed at the time SHUTUP disabled new network activity. If the 
DECnet/E event logging program EVTLOG is on and has event 2.0 enabled, it 
logs both the transition to SHUT and the one to OFF. (See the DECnet/E System 
Manager's Guide for a description of EVTLOG.) 

SHUTUP never sends special messages indicating the approach of a DECnet/E 
shutdown. Users can tell that SHUTUP is shutting down the system only from 
SHUTUP messages to all terminals and from the fact that the network is in the 
SHUT instead of the ON state. 

If the network has still not completely shut down at the end of the warning 
message phase (because active links remain), SHUTUP explicitly sets the 
network to OFF. This action disconnects all remaining logical links. SHUTUP 
then waits 15 seconds to allow affected jobs to complete network tasks and exit, 
before it enters the job killing phase. 

If you decide not to shut the system down (thus, not shut off the network) after 
you have started SHUTUP, entering a Ctrl/C to stop the execution of SHUTUP 
may reactivate the network. A Ctrl/C causes SHUTUP to print a message telling 
you the state in which the network was left. If the network is not in the state you 
want, you must use NCP to place the network and the event logger (EVTLOG) in 
the desired state. See the DECnet/E System Manager's Guide for a description of 
NCP. 


4.2.4 Initial Job Killing Phase 

In the initial job killing phase, SHUTUP begins to clear the system of currently 
active jobs. If SHUTUP finds there is only one job (itself) running on the system, 
it skips this phase and then continues the shutdown procedure at the unload and 
remove run-time systems and resident libraries phase. 

If SHUTUP is using PBS in the next phase, during this phase the program 
ignores all jobs currently associated with PBS (as indicated by entries in PBS’s 
online job table). The program also ignores any job whose primary keyboard is 
a pseudo keyboard. Such a job is probably being controlled by one of the batch 
servers. 

SHUTUP further divides all other jobs active in the system into two classes: 
attached and detached. This classification depends on whether they have an 
attached primary keyboard (KB:). For all attached jobs, SHUTUP forces the 
following text string to the keyboard input buffer: 

A C $_LOGOUT/BRIEF 

For all detached jobs, SHUTUP issues the Kill job SYS call (SYS 8) to remove the 
job. 
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SHUTUP makes two passes through the current active job table during this 
phase. In the first pass, the program terminates all active jobs not being ignored. 
At the end of the first pass, it establishes the number of attached jobs that were 
found and forced to logout. SHUTUP then waits for a specified period to allow 
the LOGOUT program to complete operations on each of the attached jobs. 

After the waiting period (if any) expires, the program makes a second pass 
through the active job table. During this pass, all jobs not being ignored are 
removed with the kill job SYS call. At the end of the pass, the program checks 
the table. If any jobs that should have been killed were not, SHUTUP aborts 
operations with the following error message: 

7SHUTUP failed in initial job killing phase 
??SHUTUP aborting - please try again later 

You should determine why SHUTUP could not kill all jobs, correct the problem, 
and run SHUTUP again. 

If SHUTUP successfully removes all jobs during the phase, or if at any time 
during either pass the number of active jobs becomes one (SHUTUP only), the 
next phase begins. 


4.2.5 Print/Batch Services Shutdown Phase (When Necessary) 

The program skips the PBS shutdown phase if PBS is not running on the system. 
If PBS is not running, SHUTUP continues with the next phase; no message is 
displayed. 

If PBS is running, SHUTUP sends a message to QMAN telling QMAN to 
shutdown PBS. QMAN acknowledges the shutdown command by sending back 
a confirmation message. If SHUTUP does not receive the confirmation message 
within two minutes after the offline request was sent, SHUTUP aborts the 
shutdown operation and displays the following: 

?No response from Print/Batch Services after 2 minutes 

Otherwise, SHUTUP displays the number of entries currently processing in PBS 
in the following format: 

Print/Batch Services shutting down -- # jobs are completing. 

Print/Batch Services shutting down — # jobs are being terminated. 

Then SHUTUP waits for QMAN to shutdown PBS. The maximum wait period is 
one hour if jobs are allowed to complete and one minute if jobs are aborted. If 
shutdown occurs in the specified time, SHUTUP displays the following message 
and goes to the next phase: 

Print/Batch Services shutdown complete at hh:mm am/pm 

Otherwise, SHUTUP aborts and displays the following error message: 

?Print/Batch Services shutdown taking too long 
??SHUTUP aborting - please try again later 


4.2.6 OPSER Shutdown Phase (When Necessary) 

The program skips the OPSER shutdown phase if: 

• OPSER is not running on the system 

• You elect not to use OPSER during the shutdown procedures 
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If you choose to use OPSER, SHUTUP immediately detaches from the terminal 
running SHUTUP OPSER reattaches to KBO: for use during OPSER’s shutdown 
procedures. As the detach occurs, the following messages appear: 

DETACHING... 

'OPSER' ATTACHING 
# 

SHUTUP sends a message to OPSER directing it to begin its shutdown proce¬ 
dures by selecting the appropriate mode of OPSER shutdown. SHUTUP then 
waits 60 seconds to see if OPSER receives the message or is functioning properly, 
or both. If OPSER does not respond properly within that time, SHUTUP attempts 
to reattach to the terminal running SHUTUP. If the operation is successful, the 
following message appears: 

70PSER not active 

??SHUTUP aborting - please try again later 

If the terminal is attached or assigned, SHUTUP waits for one second and tries 
again. You should take whatever steps are necessary to free the terminal running 
SHUTUP for use so SHUTUP can complete its activities. 

If OPSER is shutting down its online programs in the immediate mode, it sends 
each program the appropriate message to stop operations. OPSER pauses to 
make sure all programs have completed their assignments. OPSER then closes 
its files, prints the following message on the system console (KBO:), and stops 
execution: 

'OPSER' TERMINATING 

SHUTUP allows OPSER 120 seconds to complete its shutdown in the immediate 
shutdown mode. If unsuccessful, SHUTUP aborts its operations, signalling the 
failure as follows: 

70PSER shutdown taking too long 

77SHUTUP aborting - please try again later 

If OPSER is shutting down in the logical end mode, it proceeds to shutdown 
successive levels in its online job table. Appropriate system console messages 
signal the end of each job (see "SHUTUP Operation Examples"). When all online 
OPSER jobs are gone, OPSER closes its files and kills itself, freeing the system 
console for SHUTUP use again. OPSER tells you when it finishes processing with 
the message: 

'OPSER' TERMINATING 

SHUTUP allows 60 minutes in the logical end mode for OPSER to complete 
operations. If the procedure is not successful, SHUTUP aborts operations with 
the error message described previously. Otherwise, the shutdown of OPSER- 
related jobs and activities is complete and the program enters the next phase. 


4.2.7 Operator/Message Services Shutdown Phase (When Necessary) 

The program skips the Operator/Message Services (OMS) shutdown phase if OMS 
is not running on the system. If OMS is not running, SHUTUP continues with 
the next phase; no message is displayed. 
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If OMS is running, SHUTUP sends a message to the OMS receiver telling OMS 
to shut down. OMS acknowledges the shutdown command by sending back a 
confirmation message. If SHUTUP does not receive the confirmation message 
within two minutes after the shutdown request was sent, SHUTUP aborts the 
shutdown operation and displays the following message: 

?No response from Operator/Message Services after 2 minutes 

Otherwise, SHUTUP displays the number of pending requests that will be 
aborted as follows: 

Operator/Message Services shutting down after aborting # requests 

SHUTUP then waits for OMS to complete its shutdown. If the OMS shutdown 
occurs within one minute after the confirmation was received, SHUTUP displays 
the following message and goes to the next phase: 

Operator/Message Services shutdown complete at hh:mm am/pm 

Otherwise, SHUTUP aborts and displays the following error message: 

TOperator/Message Services shutdown taking too long 
??SHUTUP aborting - please try again later. 


4.2.8 EVTLOG Shutdown Phase (When Necessary) 

The SHUTUP program enters the EVTLOG shutdown phase if it finds EVTLOG 
in the message/receiver table. (DECnet/E does not need to be active for SHUTUP 
to perform this phase.) SHUTUP sends EVTLOG a special message that causes 
EVTLOG to log the shutdown occurrence on the system console, perform various 
other shutdown operations, and kill itself. 

When SHUTUP detects that EVTLOG has completed its shutdown activities and 
is no longer present, SHUTUP proceeds to the next phase. SHUTUP allows 60 
seconds for EVTLOG to complete its tasks, and if failure occurs, SHUTUP aborts 
operations with the following error message: 

7EVTLOG failed to shutdown 

77SHUTUP aborting - please try again later 

See the DECnet/E System Manager's Guide for information about the EVTLOG 
program. 


4.2.9 ERRCPY Shutdown Phase (When Necessary) 

The program enters the ERRCPY shutdown phase if the system error logging 
utility ERRCPY is present. SHUTUP sends ERRCPY a special message which 
causes ERRCPY to log the shutdown occurrence in the system error log, close the 
file, and kill itself. 

When SHUTUP detects that ERRCPY has completed its shutdown and is no 
longer present, SHUTUP proceeds to the next phase. SHUTUP allows 60 seconds 
for ERRCPY to complete its tasks. If failure occurs, SHUTUP aborts operations 
with the following error message: 

7ERRCPY failed to shutdown 

77SHUTUP aborting - please try again later 
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4.2,10 Final Job Killing Phase (When Necessary) 

If SHUTUP reaches this point, and is not the only job left running in the system 
apart from the EMT logger, SHUTUP makes one last attempt at killing all 
other remaining jobs. If SHUTUP is successful, it enters the next phase. If not 
successful, SHUTUP aborts operations with the following error message: 

7SHUTUP failed in final job killing phase 
??SHUTUP aborting - please try again later 


4.2.11 EMT Logging Shutdown Phase (When Necessary) 

The program enters the EMT logging shutdown phase if the EMT logging utility 
is present. (See Chapter 14 for a description of the EMT logger.) SHUTUP sends 
a shutdown message to the EMT logger, informing the EMT logger to stop. If the 
EMT logger does not shut down in 60 seconds, SHUTUP aborts the EMT logger 
with the following warning message: 

%EMT logger failed to shutdown - killing EMT logger job = n 

In this message, n is the job number of the EMT logger. 


4.2.12 Remove Run-Time Systems and Resident Libraries Phase 

During the remove run-time system and resident libraries phase, the program 
removes all run-time systems and resident libraries from the system tables. 
SHUTUP does not attempt to remove the primary run-time system. 


4.2.13 Log File Closing Phase 

During the log file closing phase, SHUTUP closes the log file, if it is open, and 
logs out. It then logs in again and goes on to the next phase. 


4.2.14 Swap File Removal Phase 

During the swap file removal phase, SHUTUP makes sure all installed swap files 
are removed. 


4.2.15 Disk Dismount Phase 

During the dismount phase, the program dismounts all mounted disks, both 
private and public, from the system. The system disk always remains mounted. 
If you have opened a file using the DCL commands OPEN or OPEN/LOG, or if 
you are executing SHUTUP from an indirect command file, and the file resides 
on a disk other than the system disk, an unexpected error occurs when SHUTUP 
tries to dismount the affected disk. SHUTUP aborts and you must close the file 
before retrying the shutdown. 
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4.2.16 Final Shutdown Phase 


SHUTUP enters the final shutdown phase to output the last status message, 
clears the terminal buffers, and executes the special System shutdown SYS 
call (SYS -16). The monitor transfers control to the system initialization code 
(INIT.SYS) and bootstraps the system disk. The monitor loads the initialization 
code and INIT prints the Start Timesharing <Yes>? prompt (unless you are using 
automatic restart, in which case the system restarts). 


4.2.17 SHUTUP Operation Examples 

Each of the following sections contains an example of a SHUTUP operation. 
These examples and the description of the SHUTUP program should help you to 
shut down your system correctly and in a predictable manner. 


4.2.17.1 SHUTUP Example: Large RSTS/E System 

The system in the following example is being shut down slowly. This gives system 
and network users enough time to complete their tasks. SHUTUP allows users 
to log in to the system during the entire shutdown phase; logins are disabled 
at system shutdown, after 5 minutes. Those using the network can log in until 
the 5-minute mark, after that time the system does not allow network access by 
users. However, those on the network before new network activity is disabled can 
continue to work until the system shuts down completely. 

$ run SHUTUP 

SHUTUP V10.0 RSTS V10.0 EDERE 

10:11 AM 28-May-90 ######## Set-up Dialogue Phase ######## 

Type ' A ' to any query to backup one question 

Allow Print/Batch Services jobs to complete <YES>? yes 
Use OPSER for utilities shutdown <YES>? yes 

Allow OPSER utilities to reach logical end point <YES>? yes 
Minutes until system shutdown (0-99) <5>? 15 
Minutes until logins are disabled (0-99) <0>? 5 
Minutes until new network activity is disabled (0-99) <5>? 5 

Shutdown with automatic RESTART <NO>? NO 

10:12 AM 28-May-90 ######## Warning Message Phase ######## 

15 minute warning message sent 
11 minute warning message sent 
Further LOGINS are not disabled 
Further network activity is now disabled 
8 minute warning message sent 
6 minute warning message sent 
4 minute warning message sent 
3 minute warning message sent 
2 minute warning message sent 
1 minute warning message sent 


10:27 

AM 

28-May-90 

######## 

DECNET Shutdown Phase 

######## 

10:27 

AM 

28-May-90 

######## 

Initial Job Killing Phase 

######## 

10:27 

AM 

28-May-90 

######## 

Print/Batch Shutdown Phase 

######## 

Print/Batch Services shutdown 

complete at 10:27 AM 


10:27 

AM 

28-May-90 

######## 

OMS Shutdown Phase 

######## 

Operator/Message Services shutdown complete at 10:27 AM 


10:29 

AM 

28-May-90 

######## 

EVTLOG Shutdown Phase 

######## 

10:29 

AM 

28-May-90 

######## 

ERRCPY Shutdown Phase 

######## 
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4.2.17.2 


10:29 AM 28-May-90 ######## 
10:29 AM 28-May-90 ######## 
10:29 AM 28-May-90 ######## 
10:29 AM 28-May-90 ######## 
10:29 AM 28-May-90 ######## 


Remove RTS/RES LIB Phase 
Log File Closing Phase 
SWAP File Removal Phase 
Disk DISMOUNT Phase 
Final Shutdown Phase 


Please wait for system to re-boot itself 


RSTS V10.0 EDERE (DR1) INIT V10.0 
28-May-90 10:30 AM 


######## 

######## 

######## 

######## 

######## 


Start timesharing <Yes>? 


SHUTUP Example: Small RSTS/E System 

The following example shows a system shutdown when OPSER is not present. 
Except for the absence of the first OPSER-related question, the example applies 
when OPSER is present but not used during shutdown. 

$ run SHUTUP 

SHUTUP V10.0 RSTS V10.0 EDERE 

12:24 PM 22-May-90 ######## Set-up Dialogue Phase ######## 


Type ' A ' to any query to backup one question 

Allow Print/Batch Services jobs to complete <YES>? yes 
Minutes until system shutdown (0-99) <5>? 5 

Minutes until logins are disabled (0-99) <0>? 1 

Shutdown with automatic RESTART <NO>? NO 

12:24 PM 22-May-90 ######## Warning Message Phase ######## 

5 minute warning message sent 
Further LOGINs are now disabled 
3 minute warning message sent 
2 minute warning message sent 
1 minute warning message sent 


12:24 

PM 

22-May-90 

######## 

Initial Job Killing Phase 

######## 

12:25 PM 22-May-90 ######## 

Print/Batch Services shutdown 

Print/Batch Shutdown Phase 
complete at 12:25 PM 

######## 

12:25 PM 22-May-90 ######## OMS Shutdown Phase 

Operator/Message Services shutdown complete at 12:25 PM 

######## 

12:25 

PM 

22-May-90 

######## 

EVTLOG Shutdown Phase 

######## 

12:25 

PM 

22-May-90 

######## 

ERRCPY Shutdown Phase 

######## 

12:25 

PM 

22-May-90 

######## 

Remove RTS/RES LIB Phase 

######## 

12:25 

PM 

22-May-90 

######## 

Log File Closing Phase 

######## 

12:25 

PM 

22-May-90 

######## 

SWAP File Removal Phase 

######## 

12:25 

PM 

22-May-90 

######## 

Disk DISMOUNT Phase 

######## 

12:25 

PM 

22-May-90 

######## 

Final Shutdown Phase 

######## 


Please wait for system to re-boot itself 
RSTS V10.0 EDERE (DR1) INIT V10.0 
22-May-90 - 12:24 PM 
Start timesharing <Yes>? 
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4.2.17.3 SHUTUP Example: DECnet/E Shutdown 

This example shows SHUTUP when OPSER is used to shut down a spooling 
system of five spoolers. It also illustrates how the network shuts down when a 
system includes DECnet/E support and event logging by the DECnet/E EVTLOG 
program has been enabled. 

$ run SHUTUP 

SHUTUP V10.0 RSTS V10.0 EDERE 

12:39 PM 22-May-90 ######## Set-up Dialogue Phase ######## 

Type ' A ' to any query to backup one question 

Allow Print/Batch Services jobs to complete <YES>? yes 

Use 'OPSER' for utilities shutdown <YES>? yes 

Allow OPSER utilities to reach logical end point <YES>? yes 

Minutes until system shutdown (0-99) <5>? 5 

Minutes until logins are disabled (0-99) <0>? 0 

Minutes until new network activity is disabled (0-99) <5>? 2 

Shutdown with automatic RESTART <NO>? NO 


12:40 PM 22-May- ######## Warning Message Phase ######## 

Further LOGINS are now disabled 
5 minute warning message sent 


Further network activity is now disabled 
3 minute warning message sent 


Event type 2.0, Local node state change 
Occurred 22-May-90 12:42:05.0 on node 135 (OTHG) 
Reason for state change: Operator command 
Old node state = On 
New node state = Off 

2 minute warning message sent 
1 minute warning message sent 


12:45 PM 22-May-90 ######## 

12:45 PM 22-May-90 ######## 

12:45 PM 22-May-90 ######## 

Print/Batch Services shutdown 

12:45 PM 22-May-90 ######## 

Detaching... 


DECNET Shutdown Phase 

Initial Job Killing Phase 

Print/Batch Shutdown Phase 
complete at 12:45 PM 

OPSER Shutdown Phase 


######## 

######## 

######## 

######## 


'OPSER' ATTACHING 


# 

JOB #6 'BA1SPL' 

# 

JOB #7 'BA2SPL' 

# 

JOB #5 'BA0SPL' 

# 

MESSAGE 

BA1SPL 

# 

MESSAGE 

BA2SPL 

# 

MESSAGE 

BA0SPL 


TAKEN OFFLINE 
TAKEN OFFLINE 
TAKEN OFFLINE 

949 : 22-May-90 12:45 PM JOB:3 DET 

(6) REQUESTED OFF-LINE — TAKEN OFF-LINE 

950 : 22-May-90 12:45 PM JOB:3 DET 

(7) REQUESTED OFF-LINE — TAKEN OFF-LINE 

951 : 22-May-90 12:45 PM JOB:3 DET 
(5) REQUESTED OFF-LINE — TAKEN OFF-LINE 


QUMRUN[1,2] 


QUMRUN[1,2] 


QUMRUN[1,2] 
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# 

JOB #4 'LPOSPL' TAKEN OFFLINE 

# 

MESSAGE 952 : 22-May-90 12:45 PM JOB:3 DET QUMRUN[1,2] 

LPOSPL (4) REQUESTED OFF-LINE — TAKEN OFF-LINE 

# 

JOB #3 'QUEMAN' TAKEN OFFLINE 
#'OPSER' TERMINATING 

Re-attaching... 


12:45 

PM 

22-May-90 

######## 

EVTLOG Shutdown Phase 

######## 

Shutting 

down EVTLOG by operator request. 


12:45 

PM 

22-May-90 

######## 

ERRCPY Shutdown Phase 

######## 

12:45 

PM 

22-May-90 

######## 

Final Job Killing Phase 

######## 

12:45 

PM 

22-May-90 

######## 

Remove RTS/RES LIB Phase 

######## 

12:45 

AM 

22-May-90 

######## 

Log File Closing Phase 

######## 

12:45 

PM 

22-May-90 

######## 

SWAP File Removal Phase 

######## 

12:45 

PM 

22-May-90 

######## 

Disk DISMOUNT Phase 

######## 

12:45 

PM 

22-May-90 

######## 

Final Shutdown Phase 

######## 


Please wait for system to re-boot itself 
RSTS V10.0 EDERE (DR1) INIT V10.0 
22-May-90 - 12:45 PM 
Start timesharing <Yes>? 


4.2.18 Notes on SHUTUP Operation 

You can help the users on your system by establishing administrative procedures 
that govern the hours the system is in operation. If you have a fixed shutdown 
schedule, users can plan their workload and complete tasks in the allotted hours 
of timesharing. 

You can keep them informed by placing messages in the system NOTICE.TXT 
file. The system displays the contents ofNOTICE.TXT each time a user logs in 
using a comma (,) in the PPN. This is a convenient way to make sure all users 
know about important system operations. 
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Chapter 5 


Managing Quotas 


This chapter describes the quotas that limit the use of various system resources. 
You can assign quotas to a user when you create an account. RSTS/E quotas fall 
into these categories: 

• Disk quotas 

• Job quotas 

• Send/Receive quotas 

• Dynamic region limits 

The remainder of this chapter describes these quotas in detail. See Chapter 7 for 
information on assigning or changing an account’s quotas. 


5.1 Disk Quotas 

You can limit the amount of space available to individual users on public or 
private disks by creating and maintaining quotas on those disks. Quotas are 
maintained and enforced on a per-disk basis, except for the public structure 
where it is maintained across the structure. 

You identify PPNs and assign quotas to them. The system automatically 
maintains usage counts during normal file activities. 

Each account that exists on a Level 1.2 disk, except for the [0,1] account, has a 
disk quota attribute block associated with it. The quota blocks have the following 
information: 

• Usage — Actual number of blocks on the disk taken up by your files 

• Quotas — Maximum number of blocks on the disk that your files can take up 
before the system issues an error message 

NOTE 

For disk levels 1.1 and earlier, RSTS/E used only 16 bits to store the 
disk quotas. Thus, quotas could not be as large as the size of the 
largest disk supported by RSTS/E. 
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5-1.1 Disk Quota Operations 

For pre-V9.0 disk structures, RSTS/E could only enforce disk quota limits at the 
time a user logged out. Thus, as a system manager, you could limit the amount 
of permanent disk space a user could have, but you could not limit the amount of 
temporary disk space. 

On level 1.2 disks, RSTS/E maintains two types of disk related quotas: a logged- 
in quota and a logged-out quota. If at least one user is logged in to the file’s 
account, the system automatically checks the usage count against the logged-in 
quota as users create, delete, and extend files. If no one is logged in to the file’s 
account, then RSTS/E checks the usage count against the logged-out quota. The 
system also enforces the logged-out quota when a user logs out. 

If extending the file causes the total disk usage to exceed the quota, RSTS/E 
rejects the operation and returns a ?Quota exceeded error message. When 
checking for a possible quota violation, RSTS/E takes into consideration the total 
write request. So, a write request that extends a file by multiple disk blocks is 
never only partially completed. 

lb perform the quota checks, the monitor keeps a record of the number of blocks 
that it allocates to each account on each disk. For public disks, this record is kept 
on a per disk basis, but, when quota checks are made, the counts are added up 
across the public structure. The monitor keeps the usage information in memory 
and writes it back to the disk when appropriate. If the system crashes (leaving 
old information on a disk), the disk rebuild operation (CLEAN) recomputes the 
usage and writes the correct data on the disk. 


5.1.2 Logged-In Disk Quotas 

Logged-in disk quotas are the number of disk blocks that the system lets a user 
allocate while logged in. The number of blocks in use is the total number of 
blocks allocated. The allocation of any file is its actual size in blocks, rounded up 
to the nearest full cluster. The allowable values are 0 to 16,777,214 (2 A 24 — 2), 
and UNLIMITED. Zero means that no disk storage is allowed. UNLIMITED is a 
special value that means the monitor does not enforce the logged-in quota. 

Logged-in quotas do not apply on: 

• Level 0 or Level 1.1 disk structures 

• Disks mounted using MOUNT/NOQUOTA (although the usage is still kept up 
to date) 

• Disks mounted using MOUNT/NOWRITE (because no file extends can take 
place on such a disk) 

• DVO:, which is always mounted with /NOQUOTA 


5.1.3 Logged-Out Disk Quotas 

Logged-out disk quotas are the number of disk blocks that the system lets a user 
retain at logout time. The logged-out quota is also checked when a user tries to 
create or extend a file in a logged-out account. 

The allocation of any file is its actual size in blocks, rounded up to the nearest 
full cluster. The number of blocks in use by any user is the total number of blocks 
allocated for all of the user’s files. 
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The allowable values are 0 to 16,777,214 (2 A 24 — 2), or UNLIMITED. Zero means 
that no disk storage is allowed to remain allocated at logout time. UNLIMITED 
is a special value that means the monitor does not enforce the logged-out quota. 

When a job logs out, the monitor checks the logged-out disk quota of each disk 
against the usage of that disk. For the public structure, the system disk quota is 
checked against the total usage on the public structure. If the quota is exceeded 
(and no other interactive jobs are logged in under the same account) then the 
monitor rejects the logout request. 

For level 0 and level 1.1 disk structures, the logged-out quotas remain the 
same as pre-V9.0. The allowable values are 0 to 65,535, where zero means 
UNLIMITED. 


5.2 Job Quotas 

For pre-V9.0 disk structures, there was no restriction on the number of attached 
jobs that a user was allowed to run. Thus, a user who had access to several 
terminals could gain control of a large number of job slots. In V9.0, each account 
has a job quota. 

The job quota specifies the total number of jobs (attached or detached) that each 
account can have active at any time. If the user attempts to exceed this quota, 
the system rejects the request and returns the ?Quota exceeded error message. 

If the user attempts to log in when the quota is reached, the system rejects the 
login request (see "Job Quotas and Login" below). 

The default job quota is UNLIMITED. 


5.2.1 Detached-Job Quota 

The detached job quota is an account attribute. It indicates the actual number 
of jobs that are allowed to run detached under each account. If detaching a job 
causes this quota to be exceeded, then the system rejects the request and displays 
the following message: 

?Quota exceeded 

The quota check applies even if the user issuing the request is running under 
some other account. The detached job quota does not affect the automatic 
detaching operation that takes place when carrier is lost on a dialup line 
controlling a job. In that case the job is unconditionally detached, but the quota 
is enforced when the user attempts to log back on (see the section "Job Quotas 
and Login"). 

The detached job quota defaults to zero when you create an account. 


5.2.2 Job Quotas and Login 

When a user attempts to log in, the system checks the current list of jobs under 
the account being logged in to against the quotas for that account. If either the 
detached job quota is exceeded or the job quota would be exceeded, the system 
rejects the login request. The system returns the list of currently detached jobs 
in the usual manner. 
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If a user attempts to log in to some account and the job quota has been reached, 
the result depends on whether there currently are jobs running detached under 
that account. If there are none, the system rejects the login request. If there are 
detached jobs, the system lets the user attach to one of them. 

If a user attempts to log in to some account and the detached job quota for that 
account has been exceeded, the system rejects the request but the user can attach 
to one of the detached jobs. Thus, the monitor ensures that one user cannot 
create an unlimited number of detached jobs. 


5.3 Send/Receive Quotas 

You can also limit the number of receiver ID blocks (RIBs) and the number of 
messages that a job can have at any time. 


5.3.1 RIB Quota 

Specifies the maximum number of RIBs that a job running under an account 
can set up for itself as a message receiver. The allowable range is 0 to 256 or 
UNLIMITED. UNLIMITED is a special keyword that means no RIB quota is to 
be enforced. 


5.3.2 Message Quota 

Specifies the maximum total message quota that a job running under an account 
can request when declaring itself as a receiver. This maximum total must be 
shared by however many RIBs (local and network) the job wants to set up. The 
allowable range is 0 to 65,535 or UNLIMITED. UNLIMITED is a special keyword 
that means no message quota is to be enforced. 


5.4 Dynamic Region Limits 

Dynamic regions are areas in memory created by some application programs. 
FORTRAN 77 virtual arrays are examples of dynamic regions. You must have 
the INSTAL privilege to allocate dynamic regions. If users or applications do not 
have INSTAL, they can still call on a limited pool of publicly available space. The 
size of this pool is the dynamic region limit. 

You can adjust the dynamic region limit with the DCL command SET 
SYSTEM/DYNAMICJREGIONJLIMIT. For example: 

$ SET SYSTEM/DYNAMIC_REGION__LIMIT=20 

This command sets the dynamic region limit at 20K words. As long as this 
limit remains in effect, no user or application can take more than 20K words of 
dynamic region without the INSTAL privilege. There may be less than 20K words 
available at any given time, since some of the pool may be assigned to another 
user or application. 

You need the SWCFG privilege to issue the SET SYSTEM/DYNAMIC _REGION_ 
LIMIT command. 
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Chapter 6 

Managing Privileges 


This chapter describes the privileges that you can assign to a user when creating 
an account. Privileges restrict the performance of certain system activities to 
certain users. These restrictions protect the integrity of the operating system’s 
performance and thus the integrity of service provided to users. You should grant 
privileges to each user on the basis of these factors: 

• Whether the user has a legitimate need for the privilege 

• Whether the user has the skill and experience to use the privilege without 
disrupting the system 

There are two types of privileges: RSTS/E-defined and user-defined. 


6.1 RSTS/E-Defined Privileges 

RSTS/E-defined privileges fall into several categories. The categories are based 
on the level of impact the user has on the system: 

• User—Minimum privileges to use the system effectively 

• Group—Potential to affect users inside the same group 

• World—Potential to affect users outside the same group 

• System—Potential to affect normal system operation 

• File—Potential to read or write file data 

• All—Potential to control the system 

Users can use the DCL command SET JOB/PRIVILEGE to enable and disable 
privileges for which they are authorized. Table 6—1 lists the privileges by category 
and gives a brief definition. 

The sections that follow Table 6—1 describe each privilege in alphabetical order. 
For a function-by-function description of privilege requirements, see the RSTS/E 
Programming Manual , the RSTS/E System Directives Manual , or the RSTS/E 
System User's Guide. 
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Table 6-1: RSTS/E Privileges 


Category 

Privilege 

Activity Permitted 

User 

none 

Most normal activity except those listed below 


SETPAS 

Change own password 

Group 

GACNT 

Management of all accounts in group 


GREAD 

Read access to all files in group 


GWRITE 

Write access to all files in group 

World 

EXQTA 

Exceed quotas 


RDMEM 

Read physical memory 


WACNT 

Management of all accounts 


WREAD 

Read access to all files 


WWRITE 

Write access to all files 

Files 

DATES 

Change file last access date 


DEVICE 

Access restricted devices 


GREAD 

Read access to all files in group 


GWRITE 

Write access to all files in group 


INSTAL 

Add/remove/list system files, run-time systems, 
libraries 


SYSIO 

Set privilege bit (128) of a data file 


WREAD 

Read access to all files 


WWRITE 

Write access to all files 

System 

DATES 

Change system clock 


HWCTL 

Perform system hardware control functions 


JOBCTL 

Perform job control functions 


SWCTL 

Control logins and networking 


HWCFG 

Set device characteristics 


SWCFG 

Set system parameters 


INSTAL 

Add/remove/list CCL commands 


MOUNT 

Mount and dismount devices 


OPER 

Receive, display, and respond to operator mes¬ 
sages and requests 


PBSCTL 

Control Print/Batch services 


SEND 

Send to a restricted receiver, BROADCAST 
messages 


SHUTUP 

Shut down the system 


TUNE 

Alter priority, run burst, and swapping mode 

All 

RDNFS 

Perform read-only non-file-structured I/O 


SYSIO 

Write files in [0,*] (with WWRITE) 


SYSMOD 

Modify the system 


TMPPRV 

Set privilege bit of an executable program 


WRTNFS 

Perform read/write non-file-structured I/O 
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6.1.1 DATES Privilege 

The DATES privilege lets you change the system date or time. You also need this 
privilege to change a file’s date of last access or modification. 


6.1,2 DEVICE Privilege 

The DEVICE privilege lets you allocate, read, or write data on a restricted device. 


6.1.3 EXQTA Privilege 

The exceed quota privilege (EXQTA) lets the space taken by the user’s files on a 
given volume exceed any quota set for the user (as determined by the PPN) on 
that volume. However, this privilege does not let users exceed their logged-out 
quota when logging off the system. 

This privilege also lets users specify a priority, page limit, CPU limit, or time 
limit value with a PRINT or SUBMIT command that exceeds the maximum value 
for the specified queue. 

The primary use of EXQTA is by privileged programs that need to perform certain 
operations regardless of user quotas. Normally, you would not assign EXQTA to 
users. Instead, you should set the user’s quotas to get the effect you want. 


6.1.4 GACNT Privilege 

The group accounting privilege (GACNT) lets a user perform account manage¬ 
ment functions, such as create/delete account and change passwords/quotas for 
all accounts with the same project number (group) as the user. GACNT also lets 
a user create batch jobs in any account in the user’s group. 


6.1.5 GREAD Privilege 

The group read privilege (GREAD) allows the user’s job read and execute access 
to any file whose project number is the same as the user’s. 


6.1.6 GWRITE Privilege 

The group write privilege (GWRITE) gives the user’s job create, delete, rename, 
and write access to all files that have the same project number as the user’s. 


6.1.7 HWCFG Privilege 

The hardware configuration privilege (HWCFG) lets you set terminal characteris¬ 
tics for any terminal, declare a device as restricted, create and delete the virtual 
disk, and set line printer parameters. 
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6,1.8 HWCTL Privilege 

The hardware control privilege (HWCTL) lets you perform system control 
functions, for example seizing control of a device, or hanging up a modem line. 


6.1.9 INSTAL Privilege 

The install privilege (INSTAL) lets you add, remove, or list system files. You can 
also add or remove run-time systems, resident libraries, system logical names, or 
system commands (CCLs), and create dynamic regions above the dynamic region 
limit. 


6.1.10 JOBCTL Privilege 

The job control privilege (JOBCTL) lets you read the status of any other job, kill 
a job, or remove the receiver ID block (RIB) of another job. You can also create a 
job even if logins are disabled. 


6.1.11 MOUNT Privilege 

The MOUNT privilege lets you mount shared disks, or use certain restricted 
MOUNT command qualifiers. 


6.1.12 OPER Privilege 

The OPER privilege lets you enable your terminal as an operator terminal, 
display operator messages and requests, or reply to requests made by users or 
application programs. This privilege also allows you to control the OMS package. 


6.1.13 PBSCTL Privilege 

The PBSCTL privilege lets you control the Print/Batch Services. For example, 
you can start or stop servers, or change printer forms. 


6.1.14 RDMEM Privilege 

The RDMEM privilege lets you read memory (PEEK) and perform read-only 
mapping of physical memory by executing the .PLAS system directive. 
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6.1,15 RDNFS Privilege 

The RDNFS privilege lets your job perform read-only non file-structured I/O 
operations. 

NOTE 

This privilege lets a job access data anywhere on the disk without the 
benefit of any file structure. Grant it only to users who need it. If this 
privilege is given to unqualified users who do not need it, the operating 
system and service to other users can be disrupted. Such disruptions 
can include the exposure of confidential information to unauthorized 
persons. 


6.1.16 SEND Privilege 

The SEND privilege lets you send a message to a restricted receiver. You also 
need this privilege to BROADCAST a message to a terminal. 


6.1.17 SETPAS Privilege 

The SETPAS privilege lets users change their own password. This privilege 
enables the SET PASSWORD command. 


6.1.18 SHUTUP privilege 

The SHUTUP privilege lets you run the SHUTUP program to shut down the 
system. 


6.1.19 SWCFG Privilege 

The SWCFG privilege lets you perform system configuration functions such as: 

• Setting magnetic tape label defaults 

• Setting date/time presentation formats 

• Initializing queues and servers 

• Managing DECnet 

• Assigning, deassigning, and setting the characteristics of local LAT ports 


6.1.20 SWCTL Privilege 

The software control privilege (SWCTL) lets you enable or disable logins. You 
also need this privilege to perform operational network management functions. 
(For example, turning the network or individual circuits ON and OFF, or creating 
and deleting local LAT ports.) 
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6.1.21 SYSIO Privilege 

The SYSIO privilege lets your job: 

• Create, modify, rename, or delete files in [0,*] 

• Issue commands that write into files in [0,*] such as the DUMP/SYSTEM 
command 

• Declare a network receiver that accepts inbound network connection requests 
(a network server program) 

• Declare a receiver with a name that does not end with your job number 

• Set the privilege bit in the protection code of a data file (execute bit (64) not 
set) 

• Force commands to a terminal 


6.1.22 SYSMOD Privilege 

The SYSMOD privilege lets you perform functions that could modify the system: 

• Write memory with POKE 

• Map physical memory read/write 

• Map the I/O page 

• Perform nonfile-structured reads and writes of a mounted disk 

NOTE 

This privilege lets a job access data anywhere on the disk without the 
benefit of any file structure. Grant it only to users who need it. If this 
privilege is given to unqualified users who do not need it, the operating 
system and service to other users can be disrupted. Such disruptions 
can include the destruction of information on the system device, the 
destruction of user data, and the exposure of confidential information 
to unauthorized persons. 


6.1.23 TMPPRV Privilege 

The TMPPRV privilege lets you set the privilege bit (128) in the protection code 
of a file with the execute bit (64) set. This privilege is not assigned to privileged 
programs when they are executed. Thus programs with temporary privilege 
cannot mark other programs as being privileged; a user must have TMPPRV 
privilege to perform this function. 

NOTE 

Grant the TMPPRV privilege with care because users with it can 
write and execute programs that perform system functions that are 
controlled by privileges the user does not have. 
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6.1.24 TUNE Privilege 

The TUNE privilege lets you: 

• Enable or disable disk caching 

• Enable or disable file caching 

• Lock your job in memory 

• Set the maximum size any job can occupy in physical memory (SWAP MAX) 

• Set the maximum time any job can run when compute bound (run burst) 

• Set the priority of any job 

• Change a batch server’s priority and run burst 

You can increase or decrease the priority of a job by executing the UU.PRI system 
directive or the DCL command SET JOB/PRIORITY. With the same privilege, a 
job can spawn another job with a priority other than its own. You can create such 
a job by using an optional argument to the system directive UU.JOB. 

The TUNE privilege also lets you control whether a job can be swapped out of 
memory by executing the .SET system directive with the JFLOCK bit set. 

NOTE 

Do not grant TUNE privilege widely; if unqualified users have unre¬ 
stricted ability to set job priorities, the fair and orderly scheduling of 
jobs for execution can be disrupted. 

Grant TUNE privilege only to users who need to lock a job in memory 
for performance reasons. (Typically, this will be a real-time applica¬ 
tion.) If unqualified users have the unrestricted ability to lock jobs in 
memory, physical memory may be held unnecessarily, thus degrading 
system performance. 


6.1.25 WACNT Privilege 

The world accounting privilege (WACNT) lets you perform account management 
functions, such as create/delete account and change password/quotas, for all 
accounts. You can also use it to spawn jobs or run batch jobs in any account on 
the system. 

To affect or to examine other accounts inside its own project number, a job needs 
only GACNT privilege. But to affect or examine accounts outside its own project 
number, a job needs WACNT privilege. 


6.1.26 WREAD Privilege 

The world read privilege (WREAD) gives you read and execute access to any file. 
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6.4.1 Running System Programs 

System programs provide tools for performing common tasks, such as managing 
files and developing programs. Some programs are available to all users and 
require no particular privileges to run. They have a protection code <104>. EDT 
is an example of a nonprivileged system program. 

Other system programs perform functions for privileged users. Most privileged 
system programs have a protection code <104>, unless world file access is 
required to successfully execute the program. In that case the protection code 
is <124>. The difference between the nonprivileged program and the privileged 
program that have the same protection code is that the latter verifies that a user 
has the required privileges before proceeding. 

Some privileged system programs like SHUTUP have a protection code <232> 
but require the user to have a particular privilege to gain access. In the case 
of SHUTUP, the user needs SHUTUP privilege to run the program. Access to 
privileged system programs depends on the user's set of privileges. When a user 
attempts to run a privileged program, the program first performs a privilege 
check to determine if the user is sufficiently privileged. If the user has the correct 
set of privileges, the program grants access. See the individual description of 
each system program to determine what privileges are required to gain access. 


6.4.2 Temporary Privileges 

A program that performs privileged functions for a nonprivileged user receives 
the special designation of privileged program. When run, it gives the user 
temporary privileges, that is, all privileges except SYSMOD and TMPPRV. 

When the program exits, the monitor withdraws the extra privileges from the 
user. Temporary privileges give the user access to privileged programs without 
compromising system security. 

Sometimes programs need to perform privileged functions for nonprivileged users 
For example, SHUTUP needs to PEEK at memory, an activity that requires 
RDMEM privilege. Because it is a program, SHUTUP can PEEK in a controlled 
manner. Therefore, it is not a security risk. On the other hand, unrestricted use 
of RDMEM privilege by a user can compromise system security. 


6.4.3 Designating a Program as Privileged 

A user designates an executable program as privileged by setting the privilege bit 
(128) and the executable bit (64) in the protection code. Therefore, any program 
with a protection code of <192> or higher is privileged. The normal protection 
code associated with privileged executable programs is <232>, granting execute 
access to all, but restricting read/write access to the owner. 

For security purposes, there are two restrictions regarding privileged programs: 

• A user needs TMPPRV privilege to be able to designate a program as 
privileged. 
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• A privileged program cannot reside on a disk that is mounted /NOSHARE. 
This restriction prevents an outsider from acquiring privileges by bringing in 
a privileged program on a private pack. To be able to mount a disk /SHARE, 
a user needs the MOUNT privilege. Thus, it is important that users who 
have the ability to mount disks /SHARE know the contents of the disk they 
are mounting. 


6.4.4 Running a Privileged Program 

When a user runs a privileged program, the monitor copies the account’s cur¬ 
rent privilege mask into the saved privilege mask, then it ORs all privileges 
except SYSMOD and TMPPRV into the current privilege mask, giving the user 
temporary privileges (all but SYSMOD and TMPPRV). 

It is good programming practice to have privileged programs drop privileges on 
entry, and raise them only when needed. This practice provides better protection 
against programming errors damaging the system. It thereby improves system 
security. 


6.4.5 Program exit 

Whenever a program exits or chains to another program, the monitor performs 

the following privilege-related cleanup: 

• If temporary privileges are in effect, the monitor copies the saved mask back 
into the current mask. This cancels the temporary privileges. 

• The monitor cancels any third-party privilege check currently in effect (see 
the RSTS/E Programming Manual , SYS call 31, or the RSTS/E System 
Directives Manual , general directive UU.3PP). 

• If the job is currently logged out and does not have WACNT privilege, and 
the program exits, then the monitor kills the job. Passing control from one 
program to another program is possible without restriction when a job is 
logged out, but other operations that exit the current program result in a 
self-kill. 

• If the program being exited is a privileged program, then the monitor clears 
the job’s memory and sets the job size to the minimum size for the job’s 
default keyboard monitor. 
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Chapter 7 

Managing Accounts 


This chapter gives background information on managing RSTS/E accounts and 
describes the DCL commands you use to create and maintain accounts. Table 7-1 
summarizes these commands. 


Table 7-1: DCL Commands for Managing Accounts 


Command 

Description 

CREATE/ACCOUNT 

DELETE/ACCOUNT 

SET ACCOUNT 

SET PASSWORD 

SHOW ACCOUNT 

Sets up a new account on a file-structured disk 

Deletes an account from a file-structured disk 

Changes an account’s attributes 

Changes an account’s password 

Displays account attributes 


7.1 Accounts 

An account is the structure by which RSTS/E recognizes a timesharing user, and 
in which RSTS/E maintains usage and access data. Each account is identified by 
a PPN, and can exist on any disk — public, or private. However, you can only log 
in to accounts that are defined on the booted system disk. 

The public disk structure can be one or more disks and collectively these disk(s) 
are represented by the logical name, SY:. Within the public structure, the booted 
disk is known as SYO:. You can explicitly create, delete, or modify accounts on 
SYO: or any private disk, but not on other public disks. The system automatically 
extends accounts on public disks as needed. The only command that lets you 
specify a public disk in the device specification is SHOW ACCOUNT. 

RSTS/E has two types of accounts: 

• User—Contains files and login attributes 

• Nonuser—Only contains files 

The system decides which type account to create by the following rules: 

• Explicitly by qualifier: /USER or /NOUSER 

• Implicitly by the presence of any qualifier that suggests a user account such 
as /IN_QUOTA, /PRIVILEGES, /[NO]LOOKUP, or /[NO]NETWORK 

• Neither of the above: /USER is assumed if the disk is SYO:, /NOUSER is 
assumed if the disk is private 


Managing Accounts 7-1 










7.1.1 Project-Programmer Number (PPN) 

RSTS/E identifies each account by a project-programmer number (PPN). You can 
specify the project or programmer number as a single value or a range of values. 
You assign the PPN when you create the account. The PPN cannot be changed. 
Valid PPNs are: [0,1-254] and [1-254,0-254]. 

Note that [0,1-254] are legal PPNs for nonuser accounts only; they are not legal 
PPNs for user accounts. That is, no job can log in under [0,*]. Account [0,1] is 
created when the disk is initialized, and cannot be deleted. Also, [0,1-199] are 
reserved for Digital software, [0,200] is reserved for RSTS/E and layered product 
installations, and [0,201-254] are reserved for user software packages. 


7,1.2 Account Access Privileges 

There are three categories of access to account information. A different set of 
privilege flags control each category. The categories are: 

• Read information—Read accounting data and account attributes 

— None—You can read and display accounting information in the current 
account 

— GACNT—You can read and display accounting information of any account 
in your group 

— WACNT—You can read and display accounting information of any account 

• Set information—Write accounting data and attributes to, or create or delete 
accounts 

— GACNT—You can write accounting data of any account in your group 
— WACNT—You can write accounting data of any account on the system 

• Set password—Write (change) the passwords 

— SETPAS—You can change your own password (using the SET 
PASSWORD command only) 

— GACNT—You can change the password of any account in your group 
— WACNT—You can change the password of any account on the system 

The privileges are inclusive: that is, if you have sufficient privilege to perform a 
given operation on any account in your group, you can also perform that operation 
on your own account. Similarly, if you have sufficient privilege to perform a given 
operation on any account on the system, you can perform that operation on any 
account in your group (including your own account). 


7.2 Account Data 

The following sections describe the data an account has to manage timesharing 
access and usage. Unless the section notes otherwise, each account element is: 

• Initialized by CREATE/ACCOUNT 

• Changed by SET ACCOUNT 

• Displayed by SHOW ACCOUNT 

• Deleted by DELETE/ACCOUNT 
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7.2.1 Account Name 


The account name can be 1 to 13 characters, chosen from the ASCII character 
set whose decimal values are 9, 32 through 126, and 161 through 254, which 
includes all keyboard characters. This field is displayed by the SHOW ACCOUNT 
command, by PBS on job and file header pages, and by the BROADCAST 
command on message headers. 


7.2,2 Date/Time/Keyboard of Last Interactive Login 

The date and time that the account was most recently logged in to, and the 
keyboard at which that login occurred. You cannot change these fields with 
account management commands or monitor directives. 

The keyboard number is useful only for hardwired terminals. Since LAT ter¬ 
minals are created as they are needed, their keyboard numbers are not useful 
identifiers. If you use OPSER logging, you can match up LAT keyboard numbers 
and login times to determine the server and port used. 


7.2,3 Date/Time/Keyboard of Last Noninteractive Login 

The date and time that the account was most recently logged in to by a noninter¬ 
active job, such as a batch job or a DECnet server. 


7-2.4 Date/Time of Last Password Change 

The date and time that the account’s password was most recently changed. The 
monitor maintains these data. You cannot change these fields with account 
management commands or monitor directives. 


7.2.5 Password 

Normally, the system stores an account’s password on the disk in such a way that 
it cannot be looked up. You select this form of storage with the /NOLOOKUP 
qualifier. If you need compatibility with earlier versions of RSTS/E, the /LOOKUP 
qualifier directs the system to store an account’s password on the disk in such a 
way that the UU.RAD directive can be used to look it up (see the RSTS/E System 
Directives Manual ). No Digital-supplied program displays passwords. 

For a /NOLOOKUP account, the password can be 6 to 13 characters long, chosen 
from the ASCII character set whose decimal values are 9, 32 to 62, 64 to 126, and 
161 to 254, which includes all keyboard characters. For a /LOOKUP account, the 
password must consist of six alphanumeric characters. 

A user can change an account’s password using the SET PASSWORD command if 
the user has SETPAS privilege. 

An account can also be set to the special state /NOPASSWORDJPROMPT. When 
this is so, LOGIN permits access to the account without requiring (or prompting 
for) a password. The password still exists; however, it is not used until the special 
state is cleared by setting /PASSWORD_PROMPT. 
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7.2.6 Interactive Flag 

If set, the interactive flag lets a user log in under an account. If the interactive 
flag is not set, the system does not allow a job to be logged in under this account’s 
PPN, except by the create job directive UU.JOB (see the RSTS/E System 
Directives Manual). No logins (by use of the UU.LIN system directive), interactive 
or otherwise, are allowed. 


NOTE 

Batch jobs are still allowed even if the interactive flag is not set. 


7.2.7 Captive Account Flag 

The captive account flag controls the way in which a job under a given account 
exits. If the captive flag is set, the system expects the job to remain totally under 
the control of a predetermined procedure, such as a login command procedure or 
a menu processor. Any attempt to exit to the keyboard monitor signals either an 
error or some devious action. The monitor converts such an exit request into a 
self-kill directive and removes the job. 


7.2.8 Network Flag 

The network flag, if set, lets you initiate a job under a given account over a 
network connection. This flag allows or disallows any network activity, for 
example, a remote COPY or SET HOST. 


7.2.9 Dialup Flag 

The dialup flag, if set, lets you initiate a job under a given account over dialup 
lines. 


7.2.10 Expiration Date 

The expiration date specified by this field is the last date on which you can 
initiate a job under the associated account. The system can be instructed (using 
/EXPIRE without a date argument) never to allow initiation of a job under the 
PPN of this account. The system does not delete files after the expiration date. 
That is left to the system manager. 

You can disable this field using /NOEXPIRE. The /NOEXPIRE qualifier lets an 
account remain usable indefinitely. 


7.2.11 Authorized Privilege Mask 

The authorized privilege mask specifies the maximum set of privileges that a 
job running under this account can exercise (other than by running privileged 
programs). 

When a job logs in, all authorized privileges for the account are copied to the job's 
current privilege mask. You can use commands in your LOGIN.COM file to turn 
off some privileges at login. 
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7.2.12 Creation Date 


The date that the account was created. The system assigns the creation date 
when you create the account. The creation date cannot be changed. 


7.2.13 UFD Cluster Size 

UFD cluster size is the number of 512-byte blocks that each cluster allocated to 
the account’s directory contains. You assign the UFD cluster size of a directory 
when you create an account. The UFD cluster size cannot be changed. 

An account can have a maximum of seven clusters; therefore, the UFD clustersize 
affects the maximum number of files that can be stored in the account. This 
maximum value is further affected by the size of each file, its cluster size and 
attributes. 


7.2.14 Quotas 

You can assign quotas on disk usage, job slots, and message receiver slots when 
you create an account. See Chapter 5 for a discussion of these quotas. 


7.2.15 System Data 

The system account [0,1] on the system disk, is used to support certain system 
parameters such as the system password. 


7.3 DCL Command Descriptions 

The following sections describe the commands which you can use to manage 
accounts. All parameters can be specified on the command line. 


7,3.1 CREATE/ACCOUNT Command 


This command sets up a new account on a file-structured disk. CREATE/ACCOUNT 
requires GACNT or WACNT privileges. 


Format 

CREATE/ACCOUNT [dev:][p,pn] 

Defaults 
/NOCAPTIVE 
pack cluster size 
/DETACHED_JOB_QUOTA=0 
/DIALUP 
/NOEXPIRE 

/IN_QUOTA=UNLIMITED 
/INTERACTIVE 


Command Qualifiers 
/[NOJCAPTIVE 

/CLUSTER_SIZE=ufd-cluster-size 

/DETACHED_JOB_QUOTA=detached-job-quota 

/[NO]DIALUP 

/[NO]EXPIRE[=date] 

/IN_QUOTA=logged-in-quota 

/[NOJINTERACTIVE 
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/JOB_QUOTA=job-quota 

/[NO]LOG 

/[NOJLOOKUP 

/MESSAGE_QUOTA=message-quota 

/NAME="account name" 

/[NOJNETWORK 

/OUT_QUOTA=logged-out-quota 

/[NO]PASSWORD_PROMPT 

/POSITION=position 

/PRIVILEGE=(priv[,...]) 

/RIB_QUOTA=rib-quota 

/SIZE=ufd-size 

/TEMPLATE=dev:[p,pn] 

/[NOJUSER 


/JOB_QUOTA=UNLIMITED 

/LOG 

/NOLOOKUP 
/MESSAGE_QUOTA=12 
none 

/NETWORK 

/OUT_QUOTA=UNLIMITED 

/PASSWORD_PROMPT 

/POSITION=INDEX 

/PRIVILEGE=SETPAS 

/RIB_QUOTA=3 

/SIZE=1 

your PPN 

See description 


Prompts Defaults 

Account: 

Password: Optionally, for user accounts 

Password again, for verification: Optionally, for user accounts 


Command Parameters 

dev:[p,pn] 

Device specification of a mounted device and the PPN for the account to create. 
You must specify either the device specification or PPN. The default value for dev: 
is _SY0.\ The default PPN is your PPN. You can have wildcards and ranges in 
the PPN specification. The allowable values for the PPN depend on the privileges 
you have. 

Command Qualifiers 

/[NO]CAPTIVE 

Indicates whether the account is to be a captive account. The default is 
/NOCAPTIVE. 

/CLUSTER_SIZE=ufd-cluster-size 

The number of 512-byte blocks that each cluster in this account’s UFD contains. 
Acceptable values are 1, 2, 4, 8, or 16. Disks with a PCS of 32 or 64 require 
a cluster size of 16. The value cannot be less than the pack cluster size of the 
specified disk. 

/DETACHED_JOBJ3UOTA=£tefacbed-/ob-quofa 

See Chapter 5. The default is 0. 

/[NO]DIALUP 

Indicates whether logins from dial-up terminal lines are allowed. The default is 
/DIALUP. 

/[NO]EXPIRE=date 

/NOEXPIRE means that the account is never to expire. 

/EXPIRE=date-spec means that the account expires at the end of the date you 
specify. 
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/EXPIRE without a date specification means that the account is to be marked as 
"already expired," that is, unavailable for any job to run or be created under its 
PPN. The default is /NOEXPIRE. 

/IN_QUOTA=logged-in-quota 

See Chapter 5. The allowable values are 0 to 16,777,214 and UNLIMITED. 

Zero means that no disk storage is allowed. UNLIMITED is a special keyword 
that means the monitor does not enforce the logged-in quota. The default is 
UNLIMITED. 

/[NO]INTERACTIVE 

This qualifier controls the way in which you can create a job under this account. 
If you set /NOINTERACTIVE, the system does not allow jobs to be logged in 
under this account’s PPN except by the create job directive UU.JOB (see the 
RSTS/E System Directives Manual ). 

The default is /INTERACTIVE. 

/JOB_QUOTA=job-quota 

See Chapter 5. The default is UNLIMITED. 

/[NO]LOG 

If /LOG is in effect, the CREATE function logs the creation of the new user or 
nonuser account with one of the following messages: 

User account dev:[p,pn] created at <device cluster number> 

Nonuser account dev:[p,pn] created at <device cluster number> 

The default is /LOG. 

/[NOJLOOKUP 

/NOLOOKUP means that RSTS/E stores the password in such a way that it 
cannot be looked up. The passwords must be six to fourteen characters long. 

/LOOKUP means that RSTS/E stores the password in a manner that follows 
the rules for RSTS/E versions earlier than V9.0. The passwords must be six 
characters long. 

The default is /NOLOOKUP. 

/MESSAGE_QUOTA=message-quota 

See Chapter 5. The allowable values can be from 0 to 65,535 or UNLIMITED. 
The UNLIMITED keyword means that the monitor does not enforce the message 
quota. 

The default is 12. 

/NAME= M account name M 

Can be 1 to 13 characters, chosen from the ASCII character set whose deci¬ 
mal values are 9, 32 to 126, and 161 to 254, which includes all the keyboard 
characters. 

/[NO]NETWORK 

Indicates whether logins over network connections are allowed. 

The default is /NETWORK. 

/OUT_QUOTA=logged-out-quota 

See Chapter 5. The allowable values are 0 to 16,777,214 and UNLIMITED. Zero 
means that no disk storage is allowed to remain at logout time. UNLIMITED is a 
special keyword that means the monitor does not enforce the logged-out quota. 

The default is UNLIMITED. 
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/[NO]PURGE[=QUERY] 

Controls the actions taken if the account contains files. When you specify 
/PURGE, DELETE/ACCOUNT deletes any files which it finds, and then deletes 
the account. If you specify the optional argument (=QUERY), RSTS/E displays 
a warning message if files exist for the specified account and then requests 
permission to proceed. 

When you specify /NOPURGE, DELETE/ACCOUNT displays a warning message 
if files exist in the account, skips the account, and goes to the next account if a 
wildcard account was specified: 

%Account dev:[p,pn] has n blocks of disk allocated 
Account dev:[p,pn] not deleted 

If you do not specify /PURGE, /NOPURGE, or if /PURGE=QUERY is specified, 
DELETE/ACCOUNT proceeds if no files exist. Otherwise, before proceeding, 
RSTS/E displays a prompt indicating that there are files in the account: 

Proceed (Y/N) <N> ? 

Deleting files (either by /PURGE or by answering YES to the prompt) requires 
GWRITE or WWRITE privilege. If any file deleted by DELETE/ACCOUNT has 
protected data (protection code = 128), the system writes over the file with zeros 
before deletion. 

/[NOJQUERY 

Controls the action taken if the account has nonzero accounting data or contains 
files. 

/QUERY indicates that RSTS/E displays a prompt before deleting any account. 
/NOQUERY indicates that RSTS/E only displays a message if the account has 
nonzero accounting data or contains files. 

The default is /NOQUERY. 

/[NO]RESET[=QUERY] 

Controls the action taken if the specified account has nonzero accounting data 
(CPU time, device time, connect time, or kilo-core-ticks). If you specify /RESET, 
RSTS/E deletes the account even if it has nonzero accounting data. 

If you specify the optional argument (=QUERY), RSTS/E displays a warning 
message that the specified account has nonzero accounting data and asks for 
permission to proceed. 

If you specify /NORESET, DELETE/ACCOUNT displays a warning message if 
the account has nonzero accounting data, skips the account, and goes to the next 
account if a wildcard account was specified: 

%Account dev:[p,pn] has nonzero accounting statistics 
Account dev:[p,pn] not deleted 

If you do not specify /RESET, /NORESET, or if /RESET=QUERY is specified, 
the delete account operation proceeds if the accounting data is zero. Otherwise, 
RSTS/E displays a warning message indicating that the specified account has 
nonzero data and asks for permission to proceed. 

/[ NOJUSER 

You can restrict the search for a given account to a specific type (user or nonuser) 
by using this qualifier. The default is to search all accounts. 
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Examples 


1. $ DELETE/ACCOUNT/PURGE/RESET/NOQUERY 

This command allows you to delete an account regardless of its current state. 

2. $ DELETE/ACCOUNT/NOPURGE/NORESET 

This command prevents you from deleting an account that has files or nonzero 
accounting data. 

3. $ DELETE/ACCOUNT/QUERY 

This command allows you to be prompted before deleting an account. 

4. $ DELETE/ACCOUNT 

This command allows you to be prompted only for an account that has files or 
nonzero accounting data. 
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7.3.3 SET ACCOUNT Command 


This command modifies account parameters on a file-structured disk. SET 
ACCOUNT requires GACNT or WACNT privilege. 


Format 

SET ACCOUNT dev:[p,pn] 


Command Qualifiers Defaults 

/[NOJCAPTIVE none 

/DETACHED_JOB_QUOTA=detached-job-quota none 
/[NOJDIALUP none 

/[NO]EXPIRE[=date] none 

/IN_QUOTA=logged-in-quota none 

/[NOJINTERACTIVE none 

/JOB_QUOTA=job-quota none 

/[NO]LOG /LOG 

/[NOJLOOKUP none 

/MESSAGE_QUOTA=message-quota none 

/NAME="account name" none 

/[NOJNETWORK none 

/OUT_QUOTA=logged-out-quota none 

/[NO]PASSWORD_PROMPT none 

/PRIVILEGES=(priv[,...]) none 

/RIB_QUOTA=rib-quota none 

/[NO]USER all accounts 


Prompts 

Account: 


Command Parameters 

dev:[p,pn] 

Device specification of a mounted disk and the PPN of the account to modify 
on the specified disk. You can omit either the device specification or the PPN, 
but not both. The default device specification is _SY0:. The default PPN is the 
user’s PPN. You can have wildcards and ranges in the PPN specification. RSTS/E 
uses all qualifiers that apply to a specific account and displays the following 
informational message: 

Account dev:[ppn] modified 

If no qualifiers apply to a selected account, the system displays the following 
warning message: 

%Account dev:[ppn] not modified 
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Command Qualifiers 

/[NOJCAPTIVE 

Indicates whether the account is to be a captive account. 

ID ETACH E D_J O B_Q U OTA= detached-job-quota 

See Chapter 5. 

/[NO]DIALUP 

Indicates whether logins from dial-up terminal lines are allowed. 

/[NO]EXPIRE[=date-spec] 

/NOEXPIRE means that the account is never to expire. 

/EXPIRE=date-spec means that the account is to expire at the end of the day 
specified. 

/EXPIRE without a date specification means that the account is to be marked as 
unconditionally expired, that is, unavailable for any job to run under its PPN. 

/IN_QUOTA=logged-in-quota 

See Chapter 5. 

/[NO]INTERACTIVE 

This qualifier controls the way in which you can create a job under this account. 
If you set /NOINTERACTIVE, the system does not allow jobs to be logged in 
under this account’s PPN except by the create job directive UU.JOB (see RSTS/E 
System Directives Manual ). 

/ J O B_QU OTA= job-quota 

See Chapter 5. 

/[NO]LOG 

If /LOG is in effect, the SET ACCOUNT function logs the modification of the 
account: 

Account dev:[p,pn] modified 

If /NOLOG is in effect, only warning messages are logged. 

The default is /LOG. 

/[NO]LOOKUP 

/NOLOOKUP means that RSTS/E stores the password in such a way that it 
cannot be looked up. The passwords must be six to fourteen characters long. 

/LOOKUP means that RSTS/E stores the password in a manner that follows 
the rules for RSTS/E versions earlier than V9.0. The passwords must be six 
characters long. 

/MESS AGE_QUOT A= message-quota 

See Chapter 5. 

/NAME= M account name” 

Can be 1 to 13 characters, chosen from the ASCII character set whose decimal 
values are 9, 32 to 126, and 161 to 254. 

/[NO]NETWORK 

Indicates whether logins over network connections are allowed. 

/OUT_QUOTA=logged-out-quota 

See Chapter 5. 
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/[NO]PASSWORD_PROMPT 

If you specify /NOPASSWORD_PROMPT, the account is set to not require a 
password for logging in. Ib resume password prompting, specify /PASSWORD_ 
PROMPT; the password is the same as it was before /NOPASSWORD_PROMPT 
was specified. 

/PRIVILEGE=(priv[,...]) 

This qualifier modifies the privileges currently assigned to the account. A priv 
specification occurring in the positive form adds the associated privilege to 
the account’s authorized privilege mask; a NOpriv specification removes the 
associated privilege. Note that the change affects only future logins; jobs already 
logged in are unaffected. 

A positive specification (priv) is effective only if you are authorized to have that 
privilege. However, any user with WACNT or GACNT (as appropriate) can 
remove any privilege. 

IRlBJOi\JOTA=rib-quota 

See Chapter 5. 

/[NO]USER 

You can restrict the search for a given account to a specific type (user or nonuser) 
with this qualifier. 

The default is to search all accounts. 
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7.3.4 SET PASSWORD Command 


This command lets you change the password of the specified user account. When 
you issue this command, the system responds with: 

New password: 

You then enter the desired new password. If the entry is invalid or a null string 
(Return only), the system gives the error message ?Invalid password, and returns 
to the New password prompt. The system accepts an oversize password string; 
however, it ignores the excess characters and displays a warning message. For 
nolookup accounts, the password can be 6 to 14 characters long. For lookup 
accounts, the password must be 6 characters long. 

After you enter a new password, the system prompts: 

New password again, for verification: 

You then reenter the same password. If the passwords do not match, the system 
displays the error message ?Verification mismatch, does not change the password, 
and returns to command level. If the passwords match, the system displays the 
/LOG message, if any, and returns to command level. 

Users need SETPAS (or either GACNT or WACNT) privilege to change their 
own password. Users need GACNT or WACNT privilege to change another 
accounts password. If you only have SETPAS, the system prompts you for the old 
password: 

Old password: 

You must enter the correct current password for your account. A mismatch 
results in the error message: 

?01d password validation error. 


Format 


SET PASSWORD [dev:[p,pn]] 


Command Qualifiers 
/[NO] LOG 
/SYSTEM 


Defaults 

/LOG 


none 


Prompts 
See description 
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Command Parameters 

dev:[p,pn] 

Device specification of a mounted disk, and the PPN of the account for which to 
change the password. You can omit the device specification, the PPN, or both. 
The default device specification is _SY0:. The default PPN is the user’s PPN. If a 
nonuser account is specified, the system displays a warning message: 

% [ppn] is not a user account 

You can have wildcards and ranges in the PPN specification. If a wildcard or 
range specification includes a nonuser account, RSTS/E skips the account and 
does not display a message. If the wildcard range includes lookup accounts and 
you entered a password having more than 6 characters, the password is truncated 
to the first 6 characters and a warning message is displayed. 

NOTE 

Users who only have SETPAS privilege cannot specify a dev:ppn 
parameter; in that case, RSTS/E rejects the command and displays the 
following error message: 

?Need xACNT privilege to access dev:[ppn] 

Command Qualifiers 

/[NO]LOG 

If you specify /LOG, successful setting of a new password yields: 

Password set for account dev:[p,pn] 

The default is /LOG. 

/SYSTEM 

If you specify /SYSTEM, the new password replaces the old system password. 
You must have WACNT privilege to change the system password. 


7-16 


Managing Accounts 




7.3.5 SHOW ACCOUNT Command 


This command displays account attributes. No privilege is required to dis¬ 
play your own account. You need GACNT or WACNT privilege to display other 
accounts. 

The following are samples of the output from the SHOW ACCOUNT command 
with different qualifiers. 

$ SHOW ACCOUNT/BRIEF [*,194] 


Account 

Name 

Allocation 

IDNCLP 

Last 

Login 



Expires 

[1,194] 

Blade Runner 

6016 

IDN 

P 

KB26: 

03-Dec-89 

01:24 

PM 

15-AUG-90 

[2,194] 

JT Sysgen 

5080 

I 

P 

KB32 : 

12-Nov-8 9 

02:56 

PM 


[3,194] 

JT PIP 

4336 

IDN 

P 

KB32: 

06-Nov-89 

03:06 

PM 


[4,194] 

JT ACTMGR 

3280 

IDN 

P 







[10,194] 752 

5 accounts matching _SY0:[*,194] 
Total allocation: 19464 


NOTE 

If an asterisk (*) character appears after the value in the allocation 
field, it means the account is over quota. 


$ SHOW ACCOUNT/FULL 
$.show acc/full 


SY:[194,1] 


Created: 13-Jun-90 


Privileges: 


DATES DEVICE EXQTA 
JOBCTL MOUNT OPER 
SWCFG SWCTL SYSIO 
WWRITE 


GACNT GREAD GWRITE 
PBSCTL RDMEM RDNFS 
SYSMOD TMPPRV TUNE 


HWCFG HWCTL INSTAL 
SEND SETPAS SHUTUP 
WACNT WREAD WRTNFS 


Attributes: INTERACTIVE 

NOLOOKUP 


DIALUP NETWORK 

PASSWORD PROMPT 


NOCAPTIVE 
NOEXPIRE 


Quotas: Disk usage 

Job limits 
Send/Receive 


Logged out: 
Detached: 
RIB: 


unlimited 

unlimited 

unlimited 


Logged in: 
Total: 
Message: 


unlimited 

unlimited 

unlimited 


Accounting: CPU Time: 01:09:39.3 

Device Time: 1015:41 
Connect Time: 634:24 
Blocks allocated: 27712 


Kilo-Core Ticks: 
UFD Clustersize: 

UFD Size: 
UFD Used: 


60716947 

16 

7 

86 . 8 % 


Last Password change on 19-Mar-90 at 04:04 PM 

Last interactive login on _KB45: on 07-May-90 at 09:48 AM 

Last non-interactive login on 07-May-90 at 02:09 AM 


NOTE 

If an asterisk (*) appears after the value in any field in the quotas 
section, it means the account is over quota. 
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$ SHOW ACCOUNT/ACCOUNTING_DATA [*,194] 


Account 

Name 

Allocation 

KCT 

CPU- 

-time 

Connect 

Device 

[1,194] 

Blade Runner 

6016 

52377442 

58123 

: 24.9 

903:25 

214:35 

[2,194] 

JT Sysgen 

5080 

2215 

00:00 

: 17.5 

00:15 

00:00 

[3,194] 

JT PIP 

4336 

859 

00:00 

: 08.6 

00:17 

00:00 

[4,194] 

JT ACTMGR 

3280 

797 

00:00 

: 09.7 

00:02 

00:00 


[10,194] 752 

5 accounts matching _SY0:[*,194] 

Total allocation: 19464 

NOTE 

If an asterisk (*) character appears after the value in the allocation 
field, it means the account is over quota. 


Format 


SHOW ACCOUNT dev:[p,pn] 


Command Qualifiers Defaults 


/ACCOUNTING_DATA 

/ALL 

/BRIEF 

/FULL 

/[NO]OUTPUT[=filespec] 

/[NOJRESET 

/[NOJUSER 


See discussion 
See discussion 
see discussion 
see discussion 
your terminal 
/NORESET 
all accounts 


Prompts 

none 


Command Parameters 

dev:[p,pn] 

Device specification of a mounted disk, and a PPN. The PPN can be a wildcard 
or range specification (for appropriately privileged users). You can omit both the 
device specification and the PPN. The default device specification is _SY0:. The 
default PPN is the user’s PPN. 

Command Qualifiers 

/ACCOUNTING_DATA 

Produces a one-line display of accounting data for the specified accounts. This 
qualifier conflicts with /BRIEF and /FULL. If you specify them in combination, 
the rightmost qualifier overrides the others and execution proceeds without an 
error. 

/ALL 

Produces a display of all accounts on the specified disk. If an account is specified 
along with /ALL, the account specification overrides /ALL. 
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/BRIEF 

Produces a display that uses only one line per account. You cannot use /BRIEF in 
combination with /RESET. When shown the display, the letters IDNCLP indicate 
that the account has the following attributes: 

I = Interactive 
D = Dialup 
N = Network 
C = Captive 
L = Lookup password 
P = Password prompt 

/FULL 

Produces a complete display for the accounts specified. 

/[NO]OUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 

/[ NOJRESET 

Indicates whether the accounting data is reset after being displayed. The /RESET 
qualifier requires GACNT or WACNT privilege. You cannot use /RESET in 
combination with /BRIEF. If neither /ACCOUNTING..DATA or /FULL is specified, 
/ACCOUNTING.DATA is assumed. 

The default is /NORESET. 

/[NO]USER 

Specifies which accounts are to be included in the display. /USER means only 
display accounts with login attributes. /NOUSER means only display accounts 
without login attributes. 

The default is to display all accounts. 
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Chapter 8 

Managing Terminals 


This chapter gives background information on managing terminals, either 
on your system or connected by Local Area Transport (LAT). The RSTS/E 
operating system supports a variety of terminals. The RSTS/E operating system 
automatically sets the default characteristics of all interfaces to certain standard 
values: 

• Produces hardcopy output 

• Prints data up to 80 columns wide 

• Sets autobaud detection on multiplexed lines 

You must use the SET TERMINAL command to set the characteristics of the 
terminals that do not have these standard default values. 


8.1 Understanding the SET TERMINAL Command 

The SET TERMINAL command sets characteristics for terminals attached locally 
to a RSTS/E system or for terminals connected by dialup lines. Users can use the 
SET TERMINAL command to set characteristics for their own terminals. Only 
users with HWCFG privilege can use the SET TERMINAL command to define 
characteristics for other terminals. 

The /AUTOBAUD qualifier lets the system detect and set the baud rate of any 
multiplexed terminal when the user logs in. As system manager, you can include 
SET TERMINAL/NOAUTO/PERM commands in the START.COM file for all 
multiplexed terminals for which you want to manually set the baud rate. 

There are two methods for setting the characteristics of dialup lines: 

• Nonprivileged user sets characteristics. All dialup lines start out with the 
standard default settings. Consequently, the user of a dialup line must log 
in to the system at the standard default settings, and then use the SET 
TERMINAL command to set the characteristics of the terminal. Note that 
the terminal characteristics revert to the standard settings when the user 
logs out. 

• A user with HWCFG privilege sets permanent characteristics. You can issue 
the SET TERMINAL/PERMANENT command to set the permanent charac¬ 
teristics. This causes the system to automatically use the characteristics you 
set, instead of the standard values, each time a user logs in on a particular 
dialup line. Note that the permanent characteristics remain in effect for 
the current timesharing session, unless you issue a new SET TERMINAL 
command. 
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8.2 Terminal Line Speed Characteristics File: TERSPD.SYS 


You need to create a special terminal line speed characteristics file if you have 
these two circumstances: 

• You decide to restrict the valid line speeds at certain terminals to a subset of 
the line speeds allowed by the terminal interface. 

• You install an interface that has been modified so nonstandard line speeds 
are substituted for one or more standard interface line speeds. 

The following guidelines can help you prepare a terminal line speed characteris¬ 
tics file: 

1. Gather the information on the restrictions or modifications and the keyboard 
numbers of the terminals affected. 

2. Create a file named TERSPD.SYS with a text editor. 

3. Include all of the information from step 1 in the file. 

4. Place the file in the system library account. 

NOTE 

The /AUTOBAUD qualifier does not honor the restricted speeds in 
TERSPD.SYS. 

You can use the file TERSPD.SYS to allow only certain speeds on certain 
terminals. The format for each line of the file is the terminal device designator, 
a colon, and a list of speeds to allow for that terminal; each speed separated by a 
comma. For example: 

KBF2: 300,1200,... 

The terminal device designator can be KBnn:, TTnn:, or KBcnn:. The form KBnn: 
or TTnn: produces a result that may change as new hardware is added. In the 
form (KBcnn:), c indicates the hardware controller and nn is a subline on that 
type controller. Table &-1 lists controller types that RSTS/E supports. 

Digital recommends that you use the controller form to specify terminal devices 
in the START.COM, TERSPD.SYS, and TERDFL.SYS files. In this way, if you 
change the number of pseudo keyboards, you do not have to change those files. 
The SHOW DEVICE command displays both forms of the device designator for 
each keyboard. 


Table 8-1: RSTS/E Supported Controller Types 


Code 

Controller Type 


B 

DL11 C,D type single line interface 


C 

DL11E type single line modem interface 

D 

Pseudo keyboards 


F 

DH multiplexor 


G 

DZ/DZV/DZQ multiplexor 


H 

DHV/DHU/DHQ/DHF/CXF/CXA/CXB multiplexor 
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You can specify up to 16 speeds for each terminal. You can specify a range of 
terminals on one line as low-end terminal device designator, an optional colon, 
dash, high-end terminal device designator, mandatory colon, and then the list of 
speeds. 

For example: 

KBG0-KBH8: 300,1200,... 

When you specify a terminal number without any speeds after it, no speeds are 
allowed and the speed cannot be changed. You can use blank lines, comment 
lines (lines beginning with an exclamation mark), and comments at the end of 
lines to document the file. 

An example of a TERSPD.SYS file follows: 

j 

! TERSPD.SYS 

I 

! This file is used by the system manager to define 

! those speeds which are allowed on each terminal. 

! The format is as follows: 

! KBnrlist of speeds separated by commas. 

i 

KBFO: !No speeds allowed for KBFO 

KBF1:2400,9600 !KBF1 can have either 2400 or 9600 

KBF2:-KBF4:9600 !KBF2 to KBF4 can have 9600 only 

KBF5:9600,EXTA,EXTB !KBF5 can use 9600 & external speeds 

KBF6:0,50,75, 110, 150,200,300, 600, 1200, 1800,24 00,4 800, 9600 

KBF7:0,50,75, 110, 150,200,300, 600, 1200, 1800,24 00,4 800, 9600,EXTA,EXTB 

KBF8-KBF15:0,50,75, 110, 150,200,300, 600, 1200, 1800,2400,9600 

KBG0-KBH8:50,300, 1200,2400, 4800, 9600 

KBH9:0,50,75,110,150,200,300,600,1200,1800,2400,9600 
KBH10:-KBH15:300,600,1200 1KBH10 to KBH15 are dialup lines 

NOTE 

The DLllE-type interface and the individual local interfaces (KL11 
and DL11A through DL11D) do not have programmable baud rates. 

For this reason, you cannot execute commands to change baud rates on 
a keyboard line having any of those interfaces (KBAnn, KBBnn, and 
KBCnn). 


8.3 Setting Terminals Other Than Your Own 

If you have HWCFG privilege, you can set the characteristics of other terminals 
in the RSTS/E system with the SET TERMINAL command. For example, if you 
want to set the characteristics of a VT100 terminal at KB32, type: 

$ SET TERMINAL/VT100 KB32: 

$ 

After you type the keyboard number and press the Return key, RSTS/E immedi¬ 
ately sets the characteristics of the line to those of a VT100 alphanumeric display 
terminal. DCL again displays its prompt to let you enter another command. 

You can also change specific characteristics of a terminal. For example, to limit 
the line length of the terminal at KB40, type: 

$ SET TERMINAL/WIDTH=60 KB40: 

$ 

Each time 60 characters print on KB40, the system performs a carriage return 
and line feed. 
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Use the /BROADCAST qualifier to allow your terminal to receive messages again. 
Use the /NOBROADCAST qualifier to keep messages from printing on your own 
terminal. For example: 

$ SET TERMINAL/NOBROADCAST 
$ SHOW TERMINAL/BRIEF 

Terminal: KB29: Device Type: VT52 


Break 
CRFill=0 
No Hostsync 
Scope 
Width=80 


No Broadcast 
No Delimiter 
Interactive 
Speed=9600 


Control=(R,T,C) 
No Eight_bit 
Lowercase 
Tab 


No Control=X 
No Form 

Resume=Control_C 

TTSync 


$ 

The SHOW TERMINAL command lets you verify that the command worked and 
that the rest of the terminal settings are set properly. If you decide to reverse 
this condition, use the /BROADCAST qualifier. For example: 


$ SET TERMINAL/BROADCAST 
$ SHOW TERMINAL/BRIEF 

Terminal: KB29: Device Type: VT52 


Break 
CRFill=0 
No Hostsync 
Scope 
Width=80 
$ 


Broadcast 
No Delimiter 
Interactive 
Speed=9600 


Control=(R, T, C) 
No Eight_bit 
Lowercase 
Tab 


No Control=X 
No Form 

Resume=Control_C 

TTSync 


Your terminal can now receive BROADCAST messages. 


You can also use the /NOBROADCAST and /BROADCAST qualifiers on other 
terminals on your system. Use the SET TERMINAL command as follows: 


$ SET TERMINAL KB25:/NOBROADCAST/PERM 
$ SHOW TERMINAL/BRIEF KB25: 

Terminal: KB25: Device_Type: VT100 


Break 

CRFill=0 

Hostsync 

Scope 

Width=80 

$ 


No Broadcast 
No Delimiter 
Interactive 
Speed=9600 


Control=(R,T,C) 
No Eight_bit 
Lowercase 
Tab 


No Control=X 
No Form 

Resume=Control_C 

TTSync 


8.8 Terminal Parity and Stop Bit Settings 

The next sections describe how RSTS/E handles terminal parity and stop bit 
settings. 


8.8.1 Terminal Parity 

The DCL command SET TERMINAL/[NO]PARITY[=ODD | EVEN] con¬ 
trols the format in which data characters are sent to a terminal. SET 
TERMINAL/NOPARITY (the default) sends the full 8 bits of a byte to a 
terminal. If the SET TERMINAL/NOEIGHTBIT characteristic is set, SET 
TERMINAIVPARITY=EVEN and SET TERMINAL/PARITY=ODD trim the byte 
to 7 bits and set or clear the eighth bit to achieve the correct parity setting. 
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NOTE 


Binary Output Mode is "Data Binary Output Mode". SET 
TERMINAL/NOPARITY yields 8 bit data, SET TERMINAL/PARITY=EVEN 
and SET TERMINAL/PARITY=ODD yield 7 bit data if the SET 
TERMINAL/NOEIGHTBIT characteristic is set. 

The DL11A/B/C/D/E and DJ11 interfaces do not have programmable hardware 
parity generation. For these interfaces, terminal service generates the output 
parity bit. The DH11, DHV11, DHU11 and DZ11 have programmable hardware 
parity generation, which is used by terminal service. 


8.8.2 Stop Bit Settings 

Terminal interfaces having programmable baud rate settings (DH11, DHV11, 
DHU11 and DZ11) also have programmable stop bit settings. RSTS/E auto¬ 
matically selects two stop bits for speed settings of 110 baud or less and one 
stop bit for speeds greater than 110 baud. Older mechanical terminals, such as 
the ASR33, which runs at 110 baud, require for synchronization the time delay 
provided by two stop bits. Modern terminals need only one stop bit. 

When converting from baud rates to characters per second, the correct number of 
stop bits becomes clear. Asynchronous communication consists of one start bit, 
eight data bits, and one or two stop bits. For example: 

(110 BITS PER SECOND) 

- = no /11 = 10 CHARACTERS PER SECOND 

(1+8+2 BITS PER CHARACTER) 

(300 BITS PER SECOND) 

- = 300/10 = 30 CHARACTERS PER SECOND 

(1+8+1 BITS PER CHARACTER) 


8.9 Modem Control on Leased Lines 

Some RSTS/E installations use private, leased telephone lines for terminal 
connections. If the line has no modem or no modem control (for example, data 
signals only) the line should be set as a local line using the DCL command SET 
TERMINAIVNODIALUP. In this case, the private, leased line is simply a long 
local connection. However, many private, leased lines do use modem control. 
When using modem control, RSTS/E uses five modem signals: 

1. Ring Indicator (Circuit CE, pin 22) — This signal is true when the modem is 
ringing. RSTS/E does not control this signal; the modem does. Private, leased 
lines normally do not ring. 

2. Carrier Detect (Circuit CF, pin 8) — This signal is true when the modem is 
receiving carrier from the modem on the other end of the line. RSTS/E does 
not control this signal; the modem does. 

3. Clear to Send (Circuit CB, pin 5) — This signal is true when it is permissible 
to send data to the other modem. RSTS/E does not control this signal; the 
modem does. 

4. Data Terminal Ready (Circuit CD, pin 20) — This signal is controlled by 
RSTS/E, not the modem. When RSTS/E sets this signal true, the modem 
answers (if it is not already answered) and sends carrier to the modem at the 
other end of the connection. 
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5. Request to Send (Circuit CA, pin 4) — This signal is controlled by RSTS/E, 
not the modem. When RSTS/E sets this signal true, the modem tells the 
other modem it is now clear to send data. RSTS/E always sets and clears the 
Data Terminal Ready and Request to Send lines together. 

The normal sequence for a dial-up modem line is: 

1. Someone calls in. The modem asserts Ring Indicator. 

2. RSTS/E sets the Data Tterminal Ready and Request to Send lines true. 

3. The modem answers the phone and sends out carrier and Clear to Send. The 
Ring Indicator goes off. 

4. The other end sends carrier and Request to Send. The modem sets Carrier 
Detect and Clear to Send. 

5. RSTS/E enables the line for data communication. 

6. Data communication occurs. 

7. The other end drops carrier. The modem clears Carrier Detect and Clear to 
Send. 

8. RSTS/E starts a 5 second timeout. 

9. The timeout expires. RSTS/E clears Data Terminal Ready and Request to 
Send. 

10. The connection is now broken. 

In addition, RSTS/E polls all modem lines once each second. If Carrier Detect has 
come on without a Ring Indication, the line is enabled by setting Data Terminal 
Ready and Request to Send. If Carrier Detect is on when the system is initially 
started, this happens immediately. Therefor, to use a modem-controlled private, 
leased line as a local line: 

1. Strap the Ring Indicator signal false. This ensures that RSTS/E never sees a 
ringing line. 

2. Strap the Carrier Detect and Clear to Send signals true. This ensures that 
RSTS/E immediately enables the line by setting Data Terminal Ready and 
Request to Send. 


8.10 Terminal Servers (LAT) 

RSTS/E includes support that lets systems with DECnet/E connect terminals 
directly over the Ethernet from terminal servers. These terminal connections 
are called Local Area Transport (LAT). RSTS/E also allows you to access printers 
through terminal servers if you have enabled host initiated LAT connections. 
LAT lets users access your system directly from terminals and printers connected 
to the following terminal servers: 

• Digital Ethernet Terminal Server (DECSA) 

• DECserver 100 

• DECserver 200 

• DECserver 500 

• DECserver 550 

• VAXmate systems 
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IBM-PC systems running DECnet-DOS 


The DECSA and DECserver terminal servers require that software be loaded 
into them from a host system on the Ethernet. Since RSTS/E cannot load this 
software, it must be loaded from another system. The systems currently available 
to load this software are: 

• VAX/VMS 

• ULTRIX-32 

• ULTRIX-32m 

• DECsystem-10 

• DECsystem-20 

• RSX- 11M-PLUS 

• Micro/RSX 


8,10.1 LAT Ports 

LAT ports are different from most terminals on your system because the ports 
are not physically connected to the system using terminal interfaces. RSTS/E 
connects LAT ports to terminal server posts using Ethernet hardware and 
software. 

LAT ports are similar to pseudo-keyboards and other dynamic keyboards because 
the ports are not assigned a unique keyboard unit number until until they are 
created. Dynamic keyboards are numbered sequentially, starting with the first 
available keyboard unit number that is greater than the maximum physical 
(static) keyboard unit number. 

Like other RSTS/E dynamic ports, you can reference LAT ports using the 
standard keyboard designation such as KB45:, or a device controller designation 
such as KBI3. The controller designator I is used to identify LAT ports. When 
you create a LAT port, you can specify the port number or let the system assign 
the next available number. 


8.10.2 LAT Queueing 

Some terminal servers provide the ability to queue host initiated requests that 
cannot be processed immediately because the remote port is busy. When the 
remote port becomes available, the server notifies the requesting host node that 
the connection can be made. On RSTS/E, local LAT ports are created with queued 
access by default. You can change the port setting to NOQUEUED access by 
including the /NOQUEUED qualifier in the CREATE/PORT command when you 
create the port, or in the ASSIGN/PORT or SET PORT commands after the port 
is created. When you set the LAT port to NOQUEUED, the server rejects the 
request if it is busy. You can set the LAT port to queued access by using the 
/QUEUED qualifier in the same commands. 
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8.10.3 Enabling LAT 

To support LAT terminal servers, you must have DECnet/E and the Ethernet 
hardware. If you have these, RSTS/E automatically makes LAT available. 

LAT support requires about 2K words of memory. If you are not using LAT 
on your Ethernet, use the following command to prevent LAT support in your 
system: 

$ SET SYSTEM/NOLAT 

After entering this command, you must shut the system down and restart it to 
change the state of LAT. To restore LAT support, use the SET SYSTEM/LAT 
command, followed by another shutdown and restart. 

Use the SHOW SYSTEM command to determine the current state of LAT and 
the state that will take effect after the next reboot (if different from the current 
state). 

Use the SHOW TERMINAL command to list the LAT server and port name for 
those connections coming from LAT terminal servers. 

Use the following DCL commands to set parameters for the LAT software: 


Command 

Description 

ALLOCATE 

Sets the queueing characteristic on a local LAT 
port. 

ASSIGN/PORT 

Assigns a local LAT port to a remote terminal 
server 

CREATE/PORT 

Creates a local LAT port 

CREATE/SERVICE/LAT 

Creates a LAT service 

DEASSIGN/PORT 

Deassigns a local LAT port from the assigned 
remote terminal server 

DELETE/PORT 

Deletes a local LAT port 

DELETE/SERVICE/LAT 

Deletes a LAT service 

SET NODE/LAT 

Sets LAT node characteristics 

SET PORT 

Sets local LAT port characteristics 

SET SERVICE/LAT 

Sets LAT service characteristics 

SHOW COUNTERS/LAT 

Shows LAT related counters 

SHOW NODE/LAT 

Shows LAT node characteristics 

SHOW PORT 

Shows local LAT port characteristics 

SHOW SERVICE/LAT 

Shows LAT service characteristics 

SHOW SESSIONS 

Shows information about LAT sessions 

SHOW TERMINAL_SERVERS/LAT 

Shows terminal servers known to LAT 

START/LAT 

Starts LAT on an Ethernet device 

STOP/LAT 

Stops LAT on an Ethernet device 


Each of these commands is described more fully at the end of this chapter. 
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8.10.4 Isolation of LAT Problems 


Tb isolate LAT problems, use the DCL commands SHOW COUNTERS/LAT and 
SHOW COUNTERS/LAT/DEVICE, and the DECnet/E Network Control Program 
(NCP) utility. To invoke NCP, type: 

$ RUN DECNET$:NCP 

You should then get the NCP> prompt. The following NCP commands are 
particularly useful in isolating LAT problems: 

NCP> SHOW LINE dev COUNTERS 

NCP> LOOP CIRCUIT dev PHYSICAL ADDRESS ethernet-address 

Note that dev is the name of the device being used (UNA-0 or QNA-0) and 
ethernet-address is the Ethernet address of the terminal server under question. 
See the DECnet/E System Manager's Guide for more information on these 
commands. 

For more information on LAT activity, consult the console terminal. The LOGIN 
and LOGOUT commands automatically send the server and port names for LAT 
terminals to the OPSER program, which relays the names to the console. (If 
OPSER is not running, LOGIN and LOGOUT send the names to KBO:.) 

The LOGIN command also sends the server and port names to [0,11LOGIN.COM, 
which you can modify to respond to the information as you see fit. LOGIN.COM 
automatically passes the names to the group and user LOGIN.COM files in 
Parameter P5, and executes a SET TERMINAL/INQUIRE command for the LAT 
terminal. 


8.11 Pseudo Keyboards 

The monitor dynamically creates pseudo keyboards as they are needed and 
eliminates them when they are closed. Because of this, you have no chance to 
preset any of the terminal characteristics for these pseudo keyboards. The only 
time pseudo keyboards are not available is when all 128 keyboards are in use or 
when the system is very low on buffer space. 

Some older applications require static pseudo keyboards instead of dynamic 
pseudo keyboards. OPSER BATCH requires static keyboards. Tb create these 
static pseudo keyboards, use the following command: 

$ SET SYSTEM/PSEUDO_KEYBOARD=n 

where n is the number of static pseudo keyboards needed. You can preset termi¬ 
nal characteristics for these pseudo keyboards with the SET TERMINAL/PERM 
command. 

For these commands to have any effect, you must shut the system down and 
restart. 

Use the SHOW SYSTEM command to find out the number of pseudo keyboards 
available the next time the system is rebooted. 
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8.12 Enabling Forms Management Support (FMS-11) 

Tb enable or disable FMS, use the command: 

$ SET SYSTEM/[NO]FMS 

After you issue the SET SYSTEM command, you must shut the system down and 
restart before FMS is available (or becomes unavailable). 

Use the SHOW SYSTEM command to find out the current state of FMS and the 
state that will occur the next time the system is rebooted. 

8.13 DCL Command Descriptions 

The following sections explain the commands available for managing terminals: 
SET TERMINAL, SHOW TERMINAL, and the LAT-related commands. 


8.13.1 ASSIGN/PORT Command 


This command assigns a local LAT port on the RSTS/E node to a remote ter¬ 
minal server. Use this command if you did not assign a LAT port to a terminal 
server when you created the port or to reassign the port to a different terminal 
server, port, or service. A remote service or a remote port, or both, offered by the 
specified terminal server must also be selected. ASSIGN/PORT requires SWCFG 
privilege. Example: 

$ ASSIGN/PORT KB47: KENPAT 

Port KB47: assigned with queueing to terminal-server KENPAT 


Format 


ASSIGN/PORT port-name[:] server-name 


Command Qualifiers 
/APPLICATION 
/LAT 

/[NOJLOG 

/[NOJQUEUED 

/REMOTE_PORT=remote-port-name 
/SERVICE=service-name 


Defaults 

/APPLICATION 

/LAT 

/LOG 

/QUEUED 

none 

none 


Prompts 

Local port name: 

Terminal server name: 
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Command Parameters 


port-name 

Specifies the name of the local port assigned to the terminal server. The port- 
name must be in the form of KBIrc: or KBrc: where n is a value from 0 through 
127. 

server-name 

The server-name is the name of a remote terminal server to which the port can 
be connected. The server-name can be up to 16 alphanumeric characters. 

Command Qualifiers 

/APPLICATION 

Specifies that this port is to be used as an application terminal. The default is 
/APPLICATION. 

/LAT 

Indicates that a LAT port is to be assigned. The default is /LAT. 

/[NO]LOG 

Indicates whether or not to display a confirmation message after the port is 
assigned. The default is /LOG. 

/[NO]QUEUED 

Controls whether or not the connection to a terminal server is placed on the 
server's queue if the server supports queueing and the remote port is busy. If 
/NOQUEUED is specified, the connection is not queued and if the remote port is 
busy, it fails. 

Use the SHOW PORT command to display the port’s connection status. If the 
port is set /QUEUED and the remote port is busy, a connection status of "In 
Progress" and the position in the queue is shown. 

If the qualifier is not specified, the default is /QUEUED. 

/REMOTE_PORT=remote-port-name 

Specifies the name of a remote port on the terminal server to which the local 
port is to be connected. The remote port name can be up to 16 alphanumeric 
characters. Either /REMOTE_PORT or /SERVICE or both must be specified. 

/SERVICE=service-name 

Specifies the name of a remote service offered at the terminal server to which 
the local port is to be connected, the service name can be up to 16 alphanumeric 
characters. Either /REMOTE_PORT or /SERVICE or both must be specified. 

Examples 

$ ASSIGN/PORT/REMOTE_PORT=PORT__72 KB47: LAT890 

Port KB47: assigned with queueing to terminal-server LAT890 

remote-port PORT_72 

Assigns LAT port KB47: to port PORTJ72 on terminal server LAT890. 
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8.13.2 CREATE/PORT Command 


This command creates a logical local LAT port on the RSTS/E node. Only applica¬ 
tion ports can be created. The CREATE command is also used to assign the new 
port to a terminal server, a remote service, and/or a remote port, and to specify 
whether or not connections will be queued. CREATE/PORT requires SWCTL 
privilege. Example: 

$ CREATE/PORT KB47: 

Port KB47: created 

CREATE/PORT can also be used to assign a user or system logical name to the 
new port. Assigning a system logical name requires INSTAL privileges. 


Format 


CREATE/PORT [port-name] 

Command Qualifiers 
/APPLICATION 
/LAT 

/[NO]LOG 

/LOGICAL_NAME = logical-name 
/[NOJQUEUED 

/REMOTE_PORT=remote-port-name 

/SERVICE=service-name 

/SYSTEM 

/TERMINAL_SERVER=server-name 

/USER 

Prompts 

none 


Defaults 

/APPLICATION 

/LAT 

/LOG 

/USER 

/QUEUED 

none 

none 


none 


Command Parameters 

[port-name] 

Specifies the name of the port to be created in the form of KBIrc: or KBn: where 
n is a value from 0 through 127. The controller designator I identifies LAT ports. 
If a port-name is not specified, the first available port is created and reported 
back to the user. 

Command Qualifiers 

/APPLICATION 

Specifies that this port is to be used as an application terminal. The default is 
/APPLICATION. 

/LAT 

Indicates that a LAT port is to be created. The default is /LAT. 
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/[NO]LOG 

Indicates whether or not to display a confirmation message after the port is 
created. This is especially useful if you have not specified a port-name as the port 
selected by the system is displayed. The default is /LOG. 

/LOGICAL_NAME = logical-name 

Assigns a user logical name to the newly created port. The logical name assign¬ 
ment remains in effect until you log out, log in to another account, or deassign 
the logical name using the DEASSIGN command. 

This feature is particularly useful when the CREATE/PORT command is executed 
from within a command file and the system selects the first available port. 
Subsequent commands in the command file can use the logical name instead of 
the actual port name. 

The logical name can contain up to 15 alphanumeric characters and the under¬ 
score character (_). 

If you do not also include either the /USER or the /SYSTEM qualifier, the default 
is /USER. 

/[NO]QUEUED 

Controls whether or not the connection to a terminal server is placed on the 
server’s queue if the server supports queueing and the remote port is busy. If 
/NOQUEUED is specified, the connection is not queued and if the remote port is 
busy, the connection fails. 

Use the SHOW PORT command to display the port’s connection status. If the 
port is set /QUEUED and the remote port is busy, a connection status of "In 
Progress” and the position in the queue is shown. 

If the qualifier is not specified, the default is /QUEUED. 

/REMOTE_PORT=remote-port-name 

Specifies the name of a remote port on the terminal server to which the local 
port your are creating is to be connected. The remote port name can be up to 
16 alphanumeric characters. This qualifier can only be used if you specified 
/TERMINALJ3ERVER. Either /REMOTE_PORT or /SERVICE or both must be 
specified. 

/SERVICE=service-name 

Specifies the name of a remote service on the terminal server to which the 
local port you are creating is to be connected. The service name can be up to 
16 alphanumeric characters. This qualifier can only be used if you specified 
/TERMINALJ3ERVER. Either /REMOTE JPORT or /SERVICE or both must be 
specified. 

/SYSTEM 

Assigns a system wide logical name to the newly created port. You must also 
include the /LOGICAL_NAME qualifier. A system logical name can be used by 
all jobs on the system. System logical names remain in effect until the system 
is shut down or you deassign the logical name using the DEASSIGN/SYSTEM 
command. If the system logical name is already assigned, it is replaced by the 
new assignment. 

The system logical name can contain up to 15 alphanumeric characters. You can 
include the underscore character (_) and the dollar sign ($) character; however, 
the dollar sign cannot be the first character. 
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/TERMINAL_SERVER=server-name 

Specifies the name of a terminal server to which the local port you are creating is 
to be assigned. The server name can be up to 16 alphanumeric characters. If this 
qualifier is used, then a remote port or service offered by the specified terminal 
server must be selected. Either /REMOTE_PORT or /SERVICE or both must be 
specified. 

/USER 

Assigns a user logical name to the newly created port. You must also include the 
/LOGICAL_NAME qualifier. The logical name assignment remains in effect until 
you log out, log in to another account, or deassign the logical name using the 
DEASSIGN command. If the user logical name is already assigned, it is replaced 
by the new assignment. 

The logical name can contain up to 15 alphanumeric characters and the under¬ 
score character (_). 

Examples 


l. 


$ CREATE/PORT KBIO: 
Port KB47: created 


Creates a LAT port using dynamic keyboard line KBIO: (KB47: in the exam- 
pie). 


2 . 


$ CREATE/PORT KB47: - 

/TERMINAL_SERVER=LAT890 - 
/REMOTE_PORT=PORT_72 - 
/SERVICE=PRINT 
Port KB47: created 

Port KB47: assigned with queueing to terminal-server LAT890 

remote-service PRINT 
remote-port PORT_72 

Creates a LAT port using keyboard KB47: and assigns it to port PORT_72 on 
terminal server LAT890. 


3. 


$ CREATE/PORT TERMINAL_SERVER=LAT890/SERVICE=LN03 KBIO: 

Port KB47: created 

Port KB47: assigned with queueing to terminal-server LAT890 

remote-service LN03 

Creates a LAT port using dynamic keyboard line KBIO: and assigns it to any 
port on terminal server LAT890 that offers the service named LN03. 


$ CREATE/PORT/LOGICAL_NAME=SHARED_LNO3 
Port KB48: created 

Creates a LAT port on the first available port (KB48) and assigns user logical 
name SHARED LN03 to KB48. 
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8.13.3 CREATE/SERVICE/LAT Command 


This command creates a service which is then offered by the LAT host node. 
CREATE/SERVICE/LAT requires SWCFG privilege. Example: 

$ CREATE/SERVICE/LAT EDERE 


Format 

CREATE/SERVICE/LAT service-name 

Defaults 
none 
/NOLOG 

/STATIC_RATING=255 

Prompts 

Service name: 


Command Qualifiers 
/IDENTIFICATION="service-id" 
/[NO]LOG 

/STATIC_RATING=rating 


Command Parameters 

service-name 

Gives a name for the service being created. Service names may have as many 
as 16 characters, including the multinational alphanumeric characters and the 
characters period (.), underscore (_)» hyphen (-), and dollar sign ($). Typically, the 
service name is the same as the DECnet/E node name. 

Command Qualifiers 

/IDENTIFICATION="service-id" 

Specifies a description for the service. This description is used to further identify 
the service being offered. It may be up to 64 characters in length. 

/[NO]LOG 

Specifies whether or not a confirmation message is displayed indicating that the 
requested action was taken. The default is /NOLOG. 

/STATIC_RATING=rating 

Specifies the static rating associated with the service. The valid range is 0 to 255. 
The default is /STATIC_RATING=255. 
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8.13.4 DEASSIGN/PORT Command 


This command deassigns a local LAT port on the RSTS/E node from the assigned 
remote terminal server. Once deassigned, the local port cannot be used for 
host-initiated LAT connections until it is reassigned to a terminal server and a 
remote port, or both. Normally, you do not have to use the DEASSIGN/PORT 
command because you can reassign the LAT port without first deassigning the 
port. DEASSIGN/PORT requires SWCFG privilege. Example: 

$ DEASSIGN/PORT KB47: 

Port KB47: deassigned 


Format 


DEASSIGN/PORT port-name[:] 


Command Qualifiers 
/LAT 

/[NO]LOG 


Defaults 

/LAT 

/LOG 


Prompts 
Port name: 
Service name: 


Command Parameters 

port-name 

Specifies the name of the local port to be deassigned in the form of KBI/t: or KBn: 
where n is a value from 0 through 127. 

Command Qualifiers 

/LAT 

Indicates that a LAT port is to be deassigned. The default is /LAT. 

/[NO]LOG 

Indicates whether or not to display a confirmation message after the port is 
deassigned. The default is /LOG. 
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8.13.5 DELETE/PORT Command 


This command deletes a logical local LAT port on the RSTS/E node. DELETE/PORT 
requires SWCTL privilege. Example: 

$ DELETE/PORT KB2: 

Port KB2: deleted 


Format 

DELETE/PORT port-name[:] 

Defaults 
/NOABORT 
/LAT 
/LOG 

Prompts 
Port name: 


Command Qualifiers 
/[NO]ABORT 
/LAT 

/[NO]LOG 


Command Parameters 

port-name 

Specifies the name of the local port being deleted. The port-name must be in the 
form of KBI n: or KBn: where n is a value between 0 and 127. 

Command Qualifiers 

/[NOJABORT 

Indicates whether or not to abort the connection if the port is in use. /ABORT 
terminates the current session, if any, and deletes the port. /NOABORT marks 
the port for deletion and deletes it when the current session is finished. The 
default is /NOABORT. 

/LAT 

Indicates that a LAT port is to be deleted. The default is /LAT. 

/[NO]LOG 

Specifies whether or not a confirmation message is displayed indicating that the 
port was deleted. The default is /LOG. 

Examples 

$ DELETE/PORT KB47: 

Port KB47: deleted 

This command deletes LAT port KB47:. If a session is active when you issue 
this command, the port is not deleted until the session has completed. You 
can use the /ABORT qualifier to abort the session and immediately delete the 
port. 
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8.13.6 DELETE/SERVICE/LAT Command 


This command deletes a service currently offered by the LAT host node. 
DELETE/SERVICE/LAT requires SWCFG privilege. Example: 

$ DELETE/SERVICE/LAT EDERE 


Format 

DELETE/SERVICE/LAT service-name 

Defaults 
/NOLOG 

Prompts 

Service name: 


Command Qualifiers 
/[NOJLOG 


Command Parameters 

service-name 

Specifies the service being deleted. Service names may have as many as 16 char¬ 
acters, including the multinational alphanumeric characters and the characters 
period (.), underscore (_), hyphen (-), and dollar sign ($). 

Command Qualifiers 

/[NO]LOG 

Specifies whether or not a confirmation message is displayed indicating that the 
requested action was taken. The default is /NOLOG. 
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8.13.7 SET NODE/LAT Command 


This command sets or changes the initial LAT host node characteristics. SET 
NODE/LAT requires SWCFG privilege. Example: 

$ SET NODE/LAT/IDENTIFICATION="Welcome to LAT on EDERE" 


Format 

SET NODE/LAT 

Command Qualifiers 
/ACCESS={LOCAL | DIALUP} 
/D ISABLE={group-list | ALL} 
/ENABLE={group-list | ALL} 
/IDENTIFICATION="node-id" 
/[NO]LOG 

/MULTICAST_TIMER=seconds 

Prompts 

none 


Defaults 

DIALUP 

none 

none 

none 

/NOLOG 

/MULTICAST TIMER=60 


Command Qualifiers 

/ACCESS={LOCAL | DIALUP} 

Specifies whether connections via a terminal server are treated as local or 
dialup. Most terminal servers send the host system their correct access type 
when a connection is established. However, not all terminal servers perform this 
function. In such cases, RSTS/E treats the connection as dialup by default for 
security reasons. 

This qualifier applies only to terminal servers that do not supply an access type. 
If the terminal server does supply an access type, RSTS/E ignores this qualifier. 

CAUTION 

You can compromise security if you set the access type to local for 
a terminal server that provides dialup access. For example, if your 
system requires a system password for dialup access and you define 
the access to be local, then any user dialing into the system via the 
terminal server can log in without entering the system password. 

/DISABLE=group-liSt 

Removes the specified group codes from the list of group codes associated with the 
LAT host node. The group_list can include multiple codes, separated by commas. 
For example, /DISABLE=(0,1,4,10) disables group codes 0,1,4, and 10. Use the 
keyword ALL to indicate codes 0 to 255. Specify the /DISABLE qualifier no more 
than once on a command line. No error is returned if a specified group code is not 
enabled. 
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/ENABLE=group-list 

Adds the specified group codes to the list of group codes associated with the LAT 
host node. The group_list can include multiple codes, separated by commas. 

For example, /ENABLE=(5,6,8,10) enables group codes 5,6,8, and 10. Use the 
keyword ALL for codes 0-255. Specify the /ENABLE qualifier no more than once 
on a command line. No error is returned if a specified group code is already 
enabled. 

/IDENTIFICATION="node-id" 

Specifies a description for the LAT host node. You can use this description as 
an announcement string or to further identify the node. It may be up to 64 
characters. 

/[NO]LOG 

Specifies whether or not a confirmation message is displayed indicating that the 
requested action was taken. The default is /NOLOG. 

/MULTICASTJTIMER=seconds 

Specifies the interval, in seconds, between the multicast messages sent for service 
announcements. The minimum value is 10 seconds, the maximum value is 255 
seconds. The default is 60 seconds. 
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8.13.8 SET PORT Command 



This command sets the characteristics of a LAT port on a RSTS/E node. SET 


PORT requires SWCFG privilege. Example: 



$ SET PORT/QUEUED KB2: 

Port KB2: queued 


Format 

SET PORT port-name[:] 



Command Qualifiers 

Defaults 


/LAT 

/LAT 


/[NO]LOG 

/LOG 


/[NOJQUEUED 

no change 


/[NO]REMOTE_PORT[=remote-port-name] 

none 


/[NO]SERVICE[=service-name] 

none 


Prompts 

Port name: 



Command Parameters 

port-name[:] 

Specifies the name of the port for which characteristics will be set. The port-name 
must be in the form of KBIn: or KBn:, where n is a value from 0 through 127. 

Command Qualifiers 

/LAT 

Indicates that a LAT port is to be set. The default is /LAT. 

/[NO]LOG 

Specifies whether or not a confirmation message is displayed indicating the port 
was set. The default is /LOG. 

/[ NOJQUEUED 

Controls whether or not the connection to a terminal server is placed on the 
server’s queue if the server supports queuing and the remote port is busy. If 
/NOQUEUED is specified, the connection is not queued. If the remote port is 
busy, it fails. 

Use the SHOW PORT command to display the port’s connection status. If the 
port is set /QUEUED and the remote port is busy, a connection status of "In 
Progress" and the position in the queue is shown. 

If the qualifier is not specified, no change is made to the port’s queued setting. 
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/[NO]REMOTE_PORT[=remote-port-name] 

Specifies the name of a remote port on the terminal server to which the local 
LAT port is to be connected. The remote port name can be up to 16 alphanumeric 
characters. /NOREMOTE_PORT deassigns the current remote port. Either a 
remote port or a service or both is required. 

/[NO]SERVICE[=service-name] 

Specifies the name of a remote service offered at the terminal server to which the 
local LAT port is to be connected. The service name can be up to 16 alphanumeric 
characters. /NOSERVICE deassigns the current service. Either a remote port or 
a service or both is required. 

Examples 

1 * $ SET PORT/SERVICE=PRINT_SERVICE/NOREMOTE_PORT KBIO: 

Port KB9: characteristics set as requested\ 

Port KB9: assigned with queueing to terminal-serveer SERV_1 

remote-service PRINT_SERVICE 

This command changes the service on LAT port KBIO: to PRINTJ3ERVICE 
and disassociates any remote port name from the LAT port. 
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8.13.9 SET SERVICE/LAT Command 


This command modifies the information associated with a particular service being 
offered by the node. SET SERVICE/LAT requires SWCFG privilege. Example: 

$ SET SERVICE/LAT/STATIC_RATING=40 EDERE 


Format 

SET SERVICE/LAT service-name 


Command Qualifiers Defaults 

/IDENTIFICATION="service-id" none 

/[NOJLOG /NOLOG 

/STATIC_RATING=rating none 


Prompts 

Service name: 


Command Parameters 

service-name 

Identifies the service being modified. Service names may have as many as 
16 characters, including the multinational alphanumeric characters and the 
characters period (.), underscore (_)> hyphen (-), and dollar sign ($). Typically, the 
service name is the same as the node name. 

Command Qualifiers 

/IDENTIFICATION="service-id" 

Modifies the description for the service. You can use this description to further 
identify the service being offered. 

/[NO]LOG 

Specifies whether or not a confirmation message is displayed indicating the 
requested action was taken. The default is /NOLOG. 

/STATIC_RATING=rating 

Modifies the static rating associated with the service. 


Managing Terminals 8-25 







/SCOPE 

/SELECTJERASE 

/SETUP=filespec 

/[NOJSIXEL 

/SPEED=(input[,output]) 

/[NO]TAB 

/[NOJTTSYNC 

/TYPE=n 

/[NO]UP_ARROW 
/UPPERCASE[=INPUT | OUTPUT! 
/[NO]USER_DEFINED_KEYS 
/WIDTH=n 


none 

none 

none 

none 

none 

none 

none 

none 

none 


See discussion 


none 

none 


Prompts 

none 


Command Parameters 

[KB[c]nn[:]] 

Indicates the terminal for which you want to set characteristics. For nn, you can 
specify a value in the range of 0 to 127 to identify the terminal. Optionally, you 
can specify a hardware terminal controller for c. This can be an alpha character 
from A to I. If you do not specify a terminal, RSTS/E sets the the characteristics 
of the terminal that issued the command. You must have HWCFG privilege to set 
the characteristics for another user's terminal. 

Command Qualifiers 

/[NO]132_COLUMNS 

If you specify /132_COLUMNS, the terminal displays single-width characters 
in an array of 24 lines by 132 columns. If you specify /N0132_C0LUMNS, the 
terminal displays single-width characters in an array of 24 lines by 80 columns. 

/[NO]ADVANCED_VIDEO 

If you specify /ADVANCED_VIDEO, it means the terminal has the advanced 
video option (AVO). The advanced features include character attributes (blink¬ 
ing, bolding, ..., and so on), screen memory, and ROM sockets. If you specify 
/NOADVANCED_VIDEO, it means the terminal does not support AVO. 

/[NO]ALT_MODE 

If you specify /ALT__MODE, the system treats ASCII 027, 125, and 126 as 
ESCAPE. If you specify /NOALT_MODE, the system treats only ASCII 027 code 
as ESCAPE. See /LOWERCASE for more information on the use of this qualifier. 

/[NOJANSI 

If you specify /ANSI, it means the terminal supports ANSI escape sequences. A 
terminal must be set to /ANSI to perform command line editing. If you specify 
/NOANSI, it means the terminal does not support ANSI escape sequences. The 
terminal must be set to /ANSI to support command line recall and editing. 
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/[NO]ANSWERBACK 

You must also include the /PERMANENT qualifier. If you specify /ANSWERBACK, 
the terminal sends verifying identification to electronic messaging services such 
as Telex or TWX. Users on dialup lines must run the LOGIN program by press¬ 
ing Return. /ANSWERBACK cannot be used with /AUTOBAUD. If you specify 
/NOANSWERBACK, the terminal does not send the identification message. In 
either case, the terminal can be used for normal sessions on the system. 

/[NO] AUTOBAUD 

You must also include the /PERMANENT qualifier. If you specify /AUTOBAUD, 
the system monitors the terminal line to detect and set baud rates without 
requiring the user to manually set or determine the terminal’s speed. If you 
specify /NOAUTOBAUD, the system does not set the terminal line’s speed without 
manual intervention. /AUTOBAUD cannot be used with /ANSWERBACK. 

/[NO]BREAK 

If you specify /BREAK, the system translates the BREAK key as a Ctrl/C 
character (ASCII 3). If you specify /NOBREAK, the system translates the 
BREAK key as a null character (ASCII 0). 

/[NO]BROADCAST 

The /BROADCAST qualifier enables the system broadcast capability for the 
terminal. That is, RSTS/E displays messages from the SEND system function call 
on the terminal. The /NOBROADCAST qualifier disables the system broadcast 
capability for the terminal. 

/BUFFER_QUOTA=n 

You must also include the /PERMANENT qualifier. Indicates the number of input 
characters that you can buffer before the system issues an XOFF character to 
your terminal to stop transmission. The buffer quota value is a multiple of 28. 
The allowable values range from 168 to 7140. By default, the system uses a 
quota of 168 characters. The system uses one small buffer for each 28 characters. 
Thus, the default buffer quota of 168 characters uses a maximum of six small 
buffers for terminal input. Changing a terminal’s input buffer quota is useful 
for high-speed input terminals. However, if there are not enough small buffers 
available, a terminal may not be able to reach its full quota. You must include 
the /PERMANENT qualifier when using the /B UFFER_QUOTA qualifier. You 
need HWCTL privilege to use the /BUFFER_QUOTA qualifier. 

/[NO]CONTROL=(option[,...]) 

If you specify /CONTROL=C, the system traps a Ctrl/C typed by the user and 
handles it accordingly. If you specify /NOCONTROL=C, the system ignores a 
Ctrl/C typed by the user. 

If you specify /CONTROL=R, the system enables the Ctrl/R retype facility. If you 
specify /NOCONTROL=R, the system disables the Ctrl/R retype facility. 

If you specify /CONTROL=T, the system enables the Ctrl/T job status display 
facility. If you specify /NOCONTROL=T, the system disables the Ctrl/T job status 
display facility. 

If you specify /CONTROL=X, the system traps a Ctrl/X typed by the user and 
clears the user’s entire type-ahead buffer. If you specify /NOCONTROL=X, the 
system interprets a Ctrl/X typed by the user as data. 

If you want to set or reset more than one option on a single command 
line, you can combine them in a list. For example: /CONTROL=(R,T,C) or 
/NOCONTROL=(C,X). 
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/[NO]CRFILL[=n] 

If you specify /CRFILL, the system sets the carriage return fill factor to n, where 
n is between 0 and 6. If the argument is not specified or is zero, or if /NOCRFILL 
is specified, the system does not generate any fill characters. 

/[NO]DELIMITER=c 

Allows you to select a private command line delimiter. If the argument is a 
character within quotation marks (for example /DELIMITER^'V), the character 
within quotation marks becomes the private delimiter. 

If the argument is a number (for example /DELIMITER=9), the private delimiter 
is the ASCII character whose decimal value is the number. This allows for 
any ASCII character whose decimal value is between 1 and 127 to be a private 
delimiter. 

If you specify /NODELIMITER, the system removes the private delimiter that 
was previously set. 

/[DEVICE_TYPE=terminal type 

Sets the default characteristics for the terminal type specified or, if it is a name 
of a user-defined macro, sets the characteristics defined in the macro. This 
command recognizes the following terminal types: 

LAI2 LA50 LAI80S VT55 VT105 VT220 VT340 
LA34 LA75 LA324 VT100 VT125 VT240 
LA36 LAI00 VK100 VT101 VT131 VT320 
LA38 LAI20 VT52 VT102 VT132 VT330 

See the section "User-Defined Terminal Characteristics: TERMAC.SYS" for a 
description and example of the user-defined macro file. 

/[NO]DIALUP 

You must also include the /PERMANENT qualifier. Indicates if dialup control is 
enabled for the specified terminal. Do not set the /DIALUP characteristic for a 
LAT port. If you attempt to do so, an error message is displayed. 

/[NO]EIGHT_BIT 

If you specify /EIGHT_BIT, it means the terminal supports eight bit characters. 

If you specify /NOEIGHT_BIT, it means the terminal does not support eight bit 
characters. 

/[NO]ESCAPE_SEQUENCE 

If you specify /ESCAPEJ3EQUENCE, the system treats an ESC character 
(value 27) as an indication of an incoming escape sequence. The system does 
not echo the character and or any of the characters in the sequence. If you 
specify /NOESCAPE_SEQUENCE, the system treats an ESC character (value 
27) as a line terminator and echoes it as a $ character. If the terminal is set for 
/NOESCAPEJ3EQUENCE, the arrow keys will not be available for command line 
recall and editing within applications, only at the DCL level and within other 
runtime systems. This frees the arrow keys for application-specific use. 

/[NO]FORM_FEED 

The /FORM_FEED qualifier indicates that the hardware has form feed and verti¬ 
cal tab capabilities. The system transmits form feed and vertical tab characters 
without translation. The /NOFORMJFEED qualifier indicates that the hardware 
does not have form feed and vertical tab capabilities. The system transmits four 
line feed characters in place of a form feed or vertical tab character. 
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/HARDCOPY 

If you specify /HARDCOPY, it means the terminal is not a cathode ray terminal 
(CRT) display device. The system echoes a DEL character (RUBOUT) by printing 
a backslash (\) and the last character typed and removes the last character typed 
from the terminal input buffer. Later DEL characters cause the next to last 
characters to be sequentially printed and removed from the terminal input buffer 
until a character other than DEL is received. As a result, the system echoes 
another \ to delimit the erased characters and then echoes the correct character. 

If you specify /HARDCOPY and /[NOJTTSYNC is not specified, /NOTTSYNC is 
set by default. 

/[NO]HOSTSYNC 

Specify /HOSTSYNC if the terminal has special hardware that lets the computer 
interrupt transmission of characters from the terminal by sending the terminal 
an XOFF character (value 19). Similarly, the computer instructs the terminal 
to resume transmission of characters by sending the terminal an XON character 
(value 17). The terminal hardware must respond to XOFF and XON characters 
by stopping and resuming transmission. /HOSTSYNC cannot be used with 
/RESUME=ANY. 

Specify /NOHOSTSYNC if the terminal does not have the hardware required for 
the HOSTSYNC feature. 

/INQUIRE 

Queries the terminal by sending an ANSI ESCAPE identifying sequence, then 
determines the terminal type and sets the appropriate terminal characteristics. 

If the terminal does not respond within five seconds, the system searches the file 
TERDFL.SYS to see if there are default characteristics for this terminal. If an 
entry is found, the system sets the specified characteristics. If not, the system 
displays an error message and the terminal characteristics are unchanged. 

NOTE 

This qualifier causes the terminal’s type-ahead buffer to be cleared. 

LA36 terminals do not support this feature. 

See the section "Automatic Setting of Terminal Characteristics: TERDFL.SYS" 
for more information on using /INQUIRE with terminals that do not respond to 
the identifying sequence. 

/[NO]INSERT 

Allows you to insert characters (INSERT MODE) when editing a line. In the in¬ 
sert mode, a typed character is inserted at the cursor position and any characters 
to the right of the cursor are shifted to the right. This mode becomes the default 
whenever a new line is entered. You can type CTRL/A to change modes (insert 
and overs trike) while editing a line. You can include the /PERMANENT qualifier 
to maintain the attribute setting when the terminal is not in use. You need the 
HWCTL privilege to use the /PERMANENT qualifier. 

/[NO]INTERACTIVE 

You must also include the /PERMANENT qualifier. Indicates that you can use 
the terminal to log in to the system. If you specify /NOINTERACTIVE, the 
system ignores any characters input from the terminal while it is not assigned to 
another job or not opened. Use this attribute for KB devices set up as printing 
devices. 

/[NO]KATAKANA 

Indicates that the terminal supports the Katakana character set. 
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/[NO]LINE_EDITING 

Enables or disables line editing capabilities at the program level. Line editing is 
always available at the DCL level and by other run-time systems. You can use 
the /PERMANENT qualifier to maintain the attribute setting when the terminal 
is not in use. You need the HWCTL privilege to use the /PERMANENT qualifier. 

/[NO]LOADABLE_CHARACTERS 

Indicates that the terminal supports dynamically redefinable character sets (for 
example, changing fonts). 

/[NO]LOCAL_ECHO 

If you specify /LOCAL_ECHO, the system does not echo characters it receives 
from the terminal. This is only used for a terminal that does its own local echo. 

If you specify /NOLOCAL_ECHO, characters generated are sent only to the 
computer. Therefore, the system echoes each character it receives so the character 
is displayed locally and then translates certain characters to perform the proper 
action. For example, the system echoes a CR character as a carriage return and 
line feed sequence. 

/LOWERCASE[=INPUT | OUTPUT] 

The /LOWERCASE=INPUT qualifier indicates that the system enables lowercase 
input from the terminal. The /LOWERCASE=OUTPUT qualifier indicates that 
the system enables lowercase output to the terminal. 

If you specify /LOWERCASE with no argument, the system enables lowercase 
input and output. If you specify /LOWERCASE or /LOWERCASE=INPUT and 
/[NOJALTMODE is not specified, the system sets /NOALTMODE by default. 

/[NO]OPERATOR_SERVICES[=(keyword[,...])] 

Enables the terminal as an operator services console. The optional argument 
specifies the type of requests that will be broadcast to the terminal, and 
can be ALL, NONE, [NO]REQUESTS, or [NO]MESSAGES. If you specify 
/OPERATORJ3ERVICES without an argument, ALL is assumed. If you spec¬ 
ify /NOOPERATOR_SERVICES without an argument, NONE is assumed. By 
default, all terminals are initialized to not receive operator messages or re¬ 
quests. You can use the /PERMANENT qualifier to maintain the attribute 
setting when the terminal is not in use. You need the HWCTL privilege to use 
the /PERMANENT qualifier and the OPER privilege to use the /OPERATOR_ 
SERVICES qualifier. 

/OVERSTRIKE 

Allows you to type over the current character (OVERSTRIKE MODE). When 
editing a command line, /OVERSTRIKE becomes the default when a new line 
is entered. A typed character replaces the character at the cursor position. You 
can use the /PERMANENT qualifier to maintain the attribute setting when the 
terminal is not in use. You need the HWCTL privilege to use the /PERMANENT 
qualifier. 

/[NO]PARITY=EVEN | ODD 

If you specify /NOPARITY, the system ignores the parity bit on characters it 
receives and treats the parity bit on characters it transmits to the terminal as if 
the parity bit were a data bit. 

If you specify /PARITY=EVEN, the system sends characters to the terminal with 
the parity bit properly set for even parity but ignores the parity bit on characters 
it receives. 
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If you specify /PARITY=ODD, the system sends characters to the terminal with 
the parity bit properly set for odd parity but ignores the parity bit on characters 
it receives. 

/PERMANENT 

If you specify /PERMANENT, the other qualifiers on the same command line 
become the terminal's permanent characteristics. Permanent characteristics are 
the characteristics of the terminal when it is not in use. The characteristics of 
the terminal revert to the permanent characteristics when the user logs out. 

You can use /PERMANENT to specify any characteristics of any termi¬ 
nal, including dialup controlled terminals. You must use /PERMANENT 
with /ANSWERBACK, /AUTOBAUD, /BUFFER=QUOTA, /DIALUP, and 
/INTERACTIVE. You must have HWCFG privilege to specify this qualifier. 

/[NO]PRINTER_PORT 

Indicates that the terminal has a printer port. 

/[NO]RECALL 

Enables or disables command recall capabilities at the program level. Command 
recall is always available at the DCL level and by other run-time systems. You 
can use the /PERMANENT qualifier to maintain the attribute setting when the 
terminal is not in use. You need the HWCTL privilege to use the /PERMANENT 
qualifier. 

/[ NOJREGIS 

Indicates that the terminal supports the Remote Graphic Instruction Set (ReGIS). 

/RESET 

Resets the terminal’s characteristics to the permanent characteristics. 

/[NOJRESTRICT 

If you specify /RESTRICT, it means that only users with DEVICE privilege can 
access the specified terminal. If you specify /NORESTRICT, it means that any 
users can access the specified terminal. 

This qualifier only reflects OPENs and ASSIGNs of the device: not LOGINs. 

/RESUMErANY | CONTROL_C 

Defines the XON/XOFF processing. The argument ANY enables type out and 
echo when any character is typed after XOFF. ANY is valid only on LA36 and 
VT52 terminals. The argument CONTROL__C enables type out and echo only 
when you type XON or Ctrl/C after XOFF. /RESUME=ANY cannot be used with 
/HOSTSYNC. 

/SCOPE 

Specify /SCOPE if the terminal is a CRT display terminal that has the following 
characteristics: 

• Conforms to synchronization as described under the /TTSYNC command. 

• System echoes a DEL character (RUBOUT) as backspace, space, and 
backspace sequence. 

If you specify /SCOPE, and /[NOJTTSYNC is not specified, /TTSYNC is set by 
default. 
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/[NO]SELECT_ERASE 

Indicates if the terminal supports the selectively erasable character attribute. 

If the terminal supports this feature, the terminal recognizes two forms of the 
erase in line and erase in display commands. In one form all characters within 
the set parameter are erased regardless of logical attributes. The second form 
changes all characters designated with the selectively erasable character attribute 
into spaces. 

/SETUP=filespec 

Sends the specified file’s data to the terminal, in binary mode. If you specify a 
file name only, the system assumes the file is in the user’s account on the system 
disk with a file type of .ESC. The user must have access to the file or an error 
results. Use this command to initialize a terminal for which you can make special 
software settings. 

/[ NOJSIXEL 

Indicates if the terminal supports Sixel Graphics. Sixel Graphics transfer binary 
graphic images between the host and the terminal or the terminal and a printer. 

/SPEED=(input[,output)] 

Specifies the speed at which the terminal sends and receives data. 

You can specify the speed as a single value to set the input and output baud 
rates to the same speed. To specify a split speed for input and output, specify 
/SPEED=(n,m), where the values n and m indicate the input (terminal to host) 
and output (host to terminal) baud rates, respectively. 

NOTE 

The /SPEED qualifier works on CXA, CXB, CXF, DH, DHF, DHQ, DHV, 
DHU, DZ, DZQ, and DZV terminals. Split speed does not work on DZ, 

DZQ, and DZV terminals. 

You can use the keywords EXTA and EXTB to specify a baud rate associated with 
the DH11 External Clock A and External Clock B baud rates, respectively. 

See the section "Terminal Line Speed Characteristics File: TERSPD.SYS" for a 
description and example of the speed file. 

/[NO]TAB 

/TAB indicates the terminal hardware has tab capability. The system transmits 
TAB characters without translation. 

/NOTAB indicates the terminal hardware does not have tab capability. To move 
to the next tab stop, the system transmits the correct number of space characters 
instead of transmitting a TAB character. 

/[NO]TTSYNC 

If you specify /TTSYNC, the terminal obeys the following synchronization 
standard: if the terminal sends an XOFF character (equivalent to the Ctrl/S 
combination), the computer interrupts transmission until the terminal sends 
either an XON character (equivalent to the Ctrl/Q combination) or a Ctrl/C 
combination. 

If you specify /NOTTSYNC, XON and XOFF characters sent by the terminal have 
no special meaning. 
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/TYPE=n 

Specifies the value of the terminars type code. This type code coincides with 
a particular terminal type and the SHOW TERMINAL command uses it to 
display the terminal type. This qualifier is best used in the TERMAC.SYS file to 
associate a terminal with a user-defined macro. 

Allowable values are 0 to 255. The values 0 to 128 are reserved for Digital use. 

/[NO]UP_ARROW 

If you specify /UP_ARROW, the system echoes a control and graphic charac¬ 
ter combination as the A character (value 94) followed by the proper graphic 
character. For example, Ctrl/V prints out as A V. 

If you specify /NOUP_ARROW, the system echoes the control and graphic 
character combination as is. 

/UPPERCASE[=INPUT | OUTPUT1 

The /UPPERCASE=INPUT qualifier indicates that the system disables lowercase 
input from the terminal. The /UPPERCASE=OUTPUT qualifier indicates that 
the system disables lowercase output to the terminal. 

If you specify /UPPERCASE with no argument, the system disables lowercase 
input and output. If you specify /UPPERCASE or /UPPERCASE=INPUT and 
/[NOJALTMODE is not specified, the system sets /ALTMODE by default. 

/[NO]USER_DEFINED_KEYS 

Indicates if the terminal supports User Defined Keys (UDKs). User Defined Keys 
let you save a full command string and invoke it with a single key. 

/WIDTH=n 

Sets the width of the print line for the terminal to n. The width can be between 
1 and 254. As a result, the system automatically generates a carriage return/line 
feed combination if n printing characters have been printed or echoed without 
a carriage retum/line feed combination and another printing character is to be 
transmitted. 

If the terminal executing the program is in the VT100/200 family and the print 
line width is changed, then the appropriate ESC sequences are sent to the 
terminal to change the width of the screen accordingly. For example, if the width 
changes from 80 or less to 81 or more, then the width of the screen is set to 132; 
if the width changes from 81 or more to 80 or less, the width of the screen is set 
to 80. 
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8.13.12 SHOW COUNTERS/LAT Command 


This command displays information about counters relevant to managing LAT on 
the host node. You need the SWCTL privilege to use the SHOW COUNTERS/LAT 
command. There are three types of counter information: LAT host node counters, 
terminal server counters, and Ethernet portal counters. If you do not specify 
one of these, the system displays information on node counters as the default. 
Example: 

$ SHOW COUNTERS/LAT 


LAT Host Node Counters 

Seconds since last zeroed : 882294 

Messages Transmitted : 614796 

Bytes Transmitted : 13103390 

Messages Received : 579669 

Bytes Received : 26923552 

Messages Retransmitted : 847 

Messages Received Out of Sequence : 0 

Invalid Messages Received : 8 

Invalid Slots Received : 0 

Illegal Messages Received : 0 

Illegal Slots Received s 0 

Resource Allocation Errors : 0 

Transmit Errors s 0 

Circuit Timeouts : 1 


Format 


SHOW COUNTERS/LAT 

Command Qualifiers 
/DEVICE 

/[NO]OUTPUT[=filespec] 

/[NO]NODE 

/TERMINAL_SERVERS 

/ZERO 


[server-name] 

Defaults 

none 

your terminal 
none 
none 
none 


Prompts 

none 


Command Parameters 
[server-name] 

Specifies the terminal server for which counter information displays. Server 
names may have as many as 16 characters, including the multinational alphanu¬ 
meric characters and the characters period (.), underscore (_), hyphen (-), and 
dollar sign ($). If you want to examine a terminal server, use the /TERMINAL.. 
SERVERS qualifier. If you do not use that qualifier or use the /NODE qualifier 
instead, the SHOW COUNTERS/LAT command displays information on the host 
node counters. 
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Command Qualifiers 


/DEVICE 

Displays the Ethernet device counters. These device counters pertain only to 
the portal which Ethernet has open for LAT service. The device parameter is 
optional. If you leave it out, you get information on counters for all Ethernet 
portals open for LAT service. 

/[NO]NODE 

Displays the counters for the LAT host node. /NODE is the default if neither 
/DEVICE nor /TERMINALJ3ERVERS is specified. 

/[NO]OUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 

/TERMINAL_SERVERS 

Displays the counters for the terminal server(s) known to the LAT host node. 

If a server name parameter is specified, only the counters for that server are 
displayed. If no parameter is specified, then counters for all servers known to the 
LAT host node are displayed. 

/ZERO 

Zeroes the counters after they are displayed. This qualifier acts only on the 
counter(s) that are displayed. 
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8.13.13 SHOW NODE/LAT Command 


This command displays information about the current LAT host node characteris¬ 
tics. The information displayed includes the LAT version number, the node name 
and identification, the multicast timer, and the groups to which the LAT host 
node is associated. Example: 

$ SHOW NODE/LAT 

Node Name: EDERE 

Identification: RSTS V10.0 Software at its finest 

Multicast Timer: 60 

Group Codes: 141 175 210 211 216 

LAT is enabled on line XEO: 


Format 

SHOW NODE/LAT 

Defaults 
your terminal 

Prompts 
none 


Command Qualifiers 
/[NO]OUTPUT[=filespec] 


Command Qualifiers 
/[NO]OUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on your terminal. 
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8.13.14 SHOW PORT Command 


This command displays the characteristics of LAT ports on the RSTS/E node. 

By default, both interactive and application ports are displayed. The infor¬ 
mation shown includes the local port name, the port type (either Interactive 
or Application) and the default queued setting (either Queued or Nonqueued), 
the terminal server name, the remote service (if specified), the remote port (if 
specified) and the connection status. 

If the port is not assigned to a terminal server, only the local port name and 
type are displayed. If the port is assigned but not yet connected, the requested 
terminal server, remote service, and remote port are shown. If the port is waiting 
to connect, the connection status "In Progress" is shown; if the connection is 
queued, the queue position is also displayed. If the port is connected, the terminal 
server, the remote service and the remote port to which it is actually connected 
are shown, and the job number is displayed. Example: 

$ SHOW PORT 


Port 

Type 

Terminal Server 

Remote Service 

Remote 

Port Connect Status 

KB1 

A,Q 

SERVER 1 

SERVICE_A 

PORT 1 

Connected,Job=3 

KB2 

A,NQ 

SERVER_1 


PORT_l 

Not connected 

KB3 

A,Q 

SERVER 2 

SERVICE C 


In Progress 

KB 4 
KB5 

A,Q 

A,NQ 

SERVER_2 

Not Assigned 

SERVICE_C 

PORT_2 

Queue Pos=l 

KB 6 

I,NQ 

SERVER 3 


TWA 5 5 

Connected,Job=l 

KB7 

I r NQ 

SERVER_3 


TWA56 

Connected,Job=2 


A=Application Port I=Interactive Port Q=QUEUED NQ=NOQUEUED 


Format 

SHOW/PORT [port-name] 

Defaults 
/ALL 
none 
none 
/LAT 

your terminal 

Prompts 

none 


Command Qualifiers 
/ALL 

/[NOJAPPLICATION 

/[NO]INTERACTIVE 

/LAT 

/[NO]OUTPUT[=filespec] 


Command Parameters 

port-name 

Specifies the name of the local port for which characteristics will be displayed. 
The port_name must be in the form of KBIn: or KBn: where n is a value from 0 
through 127. If a port_name is not specified, the characteristics for all ports are 
shown. 
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Command Qualifiers 


/ALL 

Generates a display of all LAT ports, both application and interactive. The 
default is /ALL. 

/[NO] APPLICATION 

Generates a display of all LAT application ports. This qualifier is ignored if a 
port_name is specified. If /NOAPPLICATION is specified, only interactive ports 
are displayed. 

/[NO]INTERACTIVE 

Generates a display of all LAT interactive ports. This qualifier is ignored if a 
port_name is specified. If /NOINTERACTIVE is specified, only application ports 
are displayed. 

/LAT 

Indicates that LAT ports are to be displayed. The default is /LAT. 

/[NO]OUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on your terminal. 
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8.13.15 SHOW SERVICE/LAT Command 


This command displays information about the service(s) offered by the LAT host 
node. If you specify a service name, only that service displays. Otherwise, all 
services offered by the LAT host are displayed. Example: 

$ SHOW SERVICE/LAT 
Service: EDERE 

Identification: Unauthorized use prohibited 
Static rating: 255 


Format 

SHOW SERVICE/LAT [service-name] 

Command Qualifiers Defaults 

/[NO]OUTPUT[=filespec] your terminal 

Prompts 

none 


Command Parameters 

[service-name] 

Specifies the service for which information is displayed. Service names may have 
as many as 16 characters, including the multinational alphanumeric characters 
and the characters period (.), underscore (_), hyphen (-), and dollar sign ($). 
Typically, the service name is the same as the node name. If you do not specify a 
service, the SHOW SERVICE/LAT command displays all the services offered by 
the LAT host. 

Command Qualifiers 

/[NO]OUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on your terminal. 
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8.13.16 SHOW SESSIONS Command 


This command displays information about the sessions which are currently 
running LAT on the host node. The information includes the RSTS/E keyboard 
number that the user is logged in to, the terminal server that the user’s terminal 
is physically connected to, and the name of the service the user is currently 
running. Example: 


$ SHOW SESSIONS 


KB 4 3 

Port: 

TWA30 

Server: 

BEANEY 

Service: 

EDERE 

KB4 6 

Port: 

WTA4 

Server: 

JTSVAX 

Service: 

EDERE 

KB48 

Port: 

PORTJ7 

Server: 

M12M12 

Service: 

EDERE 

KB 50 

Port: 

PORT 53 

Server: 

M12M12 

Service: 

EDERE 

KB47 

Port: 

PORT 68 

Server: 

M12M12 

Service: 

EDERE 

KB44 

Port: 

TWA62 

Server: 

BRAIDE 

Service: 

EDERE 

KB45 

Port: 

TWA63 

Server: 

BRAIDE 

Service: 

EDERE 

KB54 

Port: 

WTA6 

Server: 

SHERMN 

Service: 

EDERE 

KB55 

Port: 

WTA9 

Server: 

SHERMN 

Service: 

EDERE 

KB49 

Port: 

TWA87 

Server: 

BOTTLE 

Service: 

EDERE 

KB51 

Port: 

PORT_8 8 

Server: 

M12M11 

Service: 

EDERE 

KB52 

Port: 

PORT 3 

Server: 

M12M26 

Service: 

EDERE 


Format 

SHOW SESSIONS [server-name] 

Defaults 
none 
/LAT 

your terminal 

Prompts 
none 


Command Qualifiers 

/DEVICE=Ethernet-device: 

/LAT 

/[NO]OUTPUT[=filespec] 


Command Parameters 

[server-name] 

Specifies the server for which information is displayed. Server names may have 
as many as 16 characters, including the multinational alphanumeric characters 
and the characters period (.), underscore (_)> hyphen (-), and dollar sign ($). If you 
do not specify a server, the SHOW SESSIONS command displays all the servers 
operating on the LAT host. 

Command Qualifiers 

/DEVICE=Ethernet_device: 

Restricts the search to those users who are currently running LAT on the 
particular Ethernet device specified. 
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/LAT 

Indicates that LAT sessions are to be displayed. /LAT is the default; SHOW 
SESSIONS gives you the same display as SHOW SESSIONS/LAT. 

/[NO]OUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 
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8.13.17 SHOW TERMINAL Command 


This command displays the current characteristics of a specific terminal. You 
can change each of these characteristics with a corresponding option of the 
SET TERMINAL command. The SHOW TERMINAL command displays the 
current or permanent characteristics of a terminal. You can change each of these 
characteristics with a corresponding qualifier of the SET TERMINAL command. 

If the terminal is in use as a LAT port connected to a terminal server, the name 
of the server, service and remote port, or both, are also displayed. You can also 
use the SHOW TERMINAL command to display information about LAT terminal 
servers (SHOW TERMINAL_SERVERS/DAT.) 

HWCFG privilege is required to specify another user’s terminal. The following 
examples show the output format for the SHOW TERMINAL command: 


$ SHOW TERMINAL/FULL 

Terminal: KB48: Device_Type: VT340 LAT Interactive Port 

LAT Server/Port: GNUVAX/TWA8 


132_Columns Advanced__Video 

No Answerback No Autobaud 

Buffer_Quota=168 Control=(R,T,C,X) 

No Dialup Eight_Bit 

Hostsync Interactive 

No Loadable_Characters 
No Operator Overstrike 

Protocol=None Recall 

Resume=Control_C Scope 
Speed not settable Tab 
User_Defined_Keys Width=80 


No AltJMode 
Break 
CRFill=0 
Escape_Sequence 
No Katakana 
No Local_Echo 
No Parity 
Regis 

Select_Erase 

TTSync 


ANSI 

Broadcast 

No Delimiter 

No Form 

Line_editing 

Lowercase 

No Printer_Port 

Restricted 

Sixel 

Up__Arrow 


Format 


SHOW TERMINAL [KB[c]nn[:]] 


Command Qualifiers Defaults 


/ALL 

/BRIEF 

/FULL 

/[NO]OUTPUT[=filespec] 

/[NOJPERMANENT 


Current Terminal 

/BRIEF 

/BRIEF 

your terminal 

/NOPERMANENT 


Prompts 

none 


Command Parameters 
[KB[c]nn[:]] 

Indicates the terminal described in the display. When you do not specify a 
terminal, the system displays the characteristics of the terminal executing the 
command. 
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Command Qualifiers 

/ALL 

Displays the characteristics of all the terminals configured on the system. If a 
terminal is specified along with /ALL, the terminal specification overrides /ALL. 

/BRIEF 

If you specify /BRIEF, or neither /BRIEF nor /FULL, then a subset of the full 
display is shown. 

/FULL 

If you specify /FULL, the full display is shown. 

/[NO]OUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output is displayed on your terminal. 

/[NOJPERMANENT 

If you specify /PERMANENT, the system displays the permanent characteristics 
of the terminal. If you specify /NOPERMANENT, the system displays the current 
characteristics of the terminal. 
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8.13.18 SHOW TERMINAL SERVERS/LAT Command 


This command displays information about the terminal servers) known to the 
LAT host node. The server name is optional; if you omit it, information displays 
about all servers known to the LAT. Example: 


$ SHOW TERMINAL_SERVERS/LAT BEANEY 
Server: BEANEY 

Active sessions: 1 

Ethernet address: 

Keep alive timer: 

Maximum buffer size: 

LAT Protocol: 


AA-00-00-4 O-DO-OA 
20 seconds 
1518 bytes 
V5.0 


Format 

SHOW TERMINAL_SERVERS/LAT [server-name] 

Command Qualifiers Defaults 

/[NO]OUTPUT[=filespec] your terminal 

Prompts 

none 


Command Parameters 
[server-name] 

Specifies the server for which information is displayed. Server names may have 
as many as 16 characters, including the multinational alphanumeric characters 
and the characters period (.), underscore (_), hyphen (-), and dollar sign ($). If 
you do not specify a server, the SHOW TERMINAL_SERVERS/LAT command 
displays all the servers operating on the LAT host. 

Command Qualifiers 
/[NO]OUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 
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8.13.19 START/LAT Command 


This command enables LAT service. You can start LAT on a particular Ethernet 
device by specifying the device on the command line. If you specify no device, 
LAT starts on all the Ethernet devices found. You must issue a SET NODE/LAT 
command before issuing the first START/LAT command. START/LAT requires 
SWCTL privilege. Example: 

$ START/LAT XEO: 


Format 

START/LAT Ethernet-device: 

Defaults 
/LOG 

Prompts 
Ethernet device: 


Command Qualifiers 
/[NO]LOG 


Command Parameters 

Ethernet-device: 

Specifies the Ethernet portal to use for LAT. The device name is XEO: or XHO:. 

Command Qualifiers 

/[NO]LOG 

Specifies whether or not a confirmation message is displayed indicating that LAT 
has started up. The default is /LOG. 


Managing Terminals 8-47 








8.13,20 STOP/LAT Command 


This command disables LAT service on a particular Ethernet device or on all 
Ethernet devices. If no Ethernet device parameter is specified, LAT is disabled 
on all Ethernet devices. Jobs detach if they are currently running on Ethernet 
devices that get disabled. STOP/LAT requires SWCTL privilege. Example: 

$ STOP/LAT XEO: 


Format 

STOP/LAT [Ethernet-device:] 

Defaults 
/LOG 

Prompts 
none 


Command Qualifiers 
/[NO]LOG 


Command Parameters 

[Ethernet-device:] 

Specifies the Ethernet portal on which LAT is disabled. If you do not specify a 
portal, the STOP/LAT command disables LAT on all portals. Typically, there is 
only one LAT portal, XEO: or XHO:. 

Command Qualifiers 

/[NO]LOG 

Specifies whether or not a confirmation message is displayed indicating that LAT 
has stopped. The default is /LOG. 
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Chapter 9 

Managing Print/Batch Services 


This chapter gives background information on the Print/Batch Services (PBS) 
package. PBS contains routines to help you manage your RSTS/E V9.0 and later 
print and batch servers. 

The chapter then describes the DCL commands for using PBS. Table 9-1 
summarizes the DCL commands. 

Table 9-1: DCL Commands for the Print/Batch Services Package 


Command 

Description 

Package-Related 

START/QUEUE/MANAGER 

STOP/QUEUE/MANAGER 

Starts the Print/Batch Services package 

Shuts down the Print/Batch Services package 

Queue-Related 

ASSIGN/QUEUE 

CLOSE/QUEUE 

Assigns a queue to a server 

Closes a queue, preventing it from accepting additional 
entries 

DEASSIGN/QUEUE 

DELETE/QUEUE 

INITIALIZE/QUEUE 

OPEN/QUEUE 

SET QUEUE 

SHOW QUEUE 

Deassigns a queue from a server, or all servers 

Deletes a queue 

Defines a print or batch queue 

Opens a queue, allowing entries to be placed on it 
Modifies the attributes of one or more queues 

Displays the attributes and status of one or more 
queues 

START/QUEUE 

Starts a queue, allowing entries to be routed to servers 
for processing 

STOP/QUEUE 

Stops a queue, preventing entries from being routed to 
servers for processing 

Server-Related 

DELETE/SERVER 

INITIALIZE/SERVER 

SET SERVER 

SHOW SERVER 

Deletes a print or batch server 

Defines a print or batch server 

Modifies the attributes of one or more servers 

Displays the attributes and status of one or more 
servers 


(continued on next page) 
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Table 9-1 (Cont.): DCL Commands for the Print/Batch Services Package 


Server-Related 

START/SERVER 

Starts a print or batch server that was stopped 

STOP/SERVER 

Stops a print or batch server immediately or when a 
specified event occurs 

Entry-Related 

DELETE/ENTRY 

Deletes one or more print or batch entries selected by 
entry-spec or entry-number 

PRINT 

Queues a request for printing one or more files 

SET ENTRY 

Modifies the attributes of one or more print or batch 
entries 

SHOW ENTRY 

Displays the attributes and status of one or more print 
or batch entries 

SUBMIT 

Queues a request for batch processing one or more 
command files 


9.1 Managing the Print/Batch Services Package 

The PBS package provides several important services for RSTS/E users and 
system managers. The major components of PBS are: 

• Queue Manager 

• Print Servers 

• Batch Servers 

• User Interface 

The Queue Manager accepts all user requests, controls all print and batch 
queues, schedules jobs to run, and creates new jobs as needed to process requests. 

Print servers process print requests on selected printers. Both line printers (LP) 
and terminals (KB) can be handled by print servers. 

Batch servers control execution of submitted command procedures, using the DCL 
command file processor (see RSTS/E Guide to Writing Command Procedures). 
You can establish multiple batch servers to process several command procedures 
at the same time. 

The user interface is how an application program communicates with PBS. It 
lets the user program issue requests for print and batch services. User Request 
Packets (see RSTS/E Programming Manual ) provide this link between PBS and 
the user application programs. 

PBS semds messages to OMS to notify operators of significant events. These 
events occur when: 

• A print or batch entry is started 

• A print or batch entry is completed 

• A print or batch entry is deleted 

• A print server goes off line while processing an entry 

• One or more print entries is waiting for a forms change. 
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9.1.1 Queue Manager 

The Queue Manager module is an integral part of PBS. The term queue refers 
to a list of pending print or batch requests. The term entry describes a request 
on a queue. Normally, PBS adds new entries to the end or tail of a queue. PBS 
processes an entry when it reaches the front or head of the queue. 

PBS creates an entry on a queue in response to a user request for print or batch 
services. The entry remains on a queue until its requested job is completed, or 
until it is explicitly deleted by an operator or user. PBS assigns a priority to 
every queue entry which establishes its position on the queue relative to other 
entries. For example, PBS inserts a high-priority entry in the queue ahead of 
existing lower priority entries instead of at the end. 

The PBS work file PBS$:PBS.SYS contains all the queue definitions. You define 
a new queue with the INITIALIZE/QUEUE command. Once you define a queue 
it remains in the file until it is explicitly deleted. You delete a queue with 
the DELETE/QUEUE command. PBS periodically compresses PBS$:PBS.SYS, 
based on the number of print and batch entries deleted from the file since 
the last file compression. If a user issues a PRINT or SUBMIT command 
while PBS is compressing the work file, the user may receive a "Waiting for 
acknowledgement..." message indicating that PBS has not yet received the 
request. 


9.1.1.1 Queue Types 

PBS uses two types of queues: 

• Print - The PRINT command creates entries in a print queue 

• Batch - The SUBMIT command creates entries in a batch queue 

You can define several queues for each type, but each queue can only have a 
single type associated with it. Note that once you define a queue as a print or 
batch queue, you cannot change its type. 


9.1.1.2 Queue Names 

Every queue must have a unique name. This name can consist of 1 to 9 char¬ 
acters from the set A-Z, 0-9, $, and _, and must begin with an alphanumeric 
character. PBS always forces lowercase characters in queue names to upper¬ 
case. You need a trailing colon when you include the queue name in an entry 
specification. Otherwise, the colon is optional. 

Queue names must be unique, regardless of type. For example, if you define a 
print queue named SYSTEM, then you cannot also define a batch queue with the 
name SYSTEM. 


9.1.1.3 Default Queues 

You can define one default print queue and one default batch queue. When 
a user issues a PRINT or SUBMIT command and does not specify a queue 
name, PBS places the request on the appropriate default queue. You can change 
default queues at any time by using the SET QUEUE command. As distributed, 
PBS defines the default print queue SYS$PRINT and the default batch queue 
SYS$BATCH. 

You do not have to define default queues. However, if you do not, a user must 
specify the queue on which to place each print or batch request. 
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9.1.1.4 Assigning Servers to Queues 

Once you define a queue, users can submit requests to be placed on that queue. 
You must also indicate which servers are to process requests on that queue. You 
can define servers with the INITIALIZE/SERVER command. 

In the simplest configuration, you assign each queue to a single server, and you do 
not assign two queues to the same server. Figure 9-1 shows this configuration. 


Figure 9-1: One-to-One Configuration 



The one-to-one configuration is useful when users need to have their print re¬ 
quests printed on a particular printer or their batch request processed by a 
specific batch server. In such cases, you can choose the queue name to match its 
assigned server’s name, such as print queue LPO: or batch queue BAO:. 

It may be useful to assign more than one server to a queue, an option which is 
useful when multiple devices with the same characteristics exist. For example, at 
a site with two letter-quality printers (for example, KB11: and KB12:), you could 
define one print queue named LQ and assign it to servers controlling each device. 
Figure 9-2 shows this configuration. 

Figure 9-2: One-to-Many Configuration 


Queue LQ 




The one-to-many configuration is useful when one class of devices can process 
similar jobs. When a user places a print request on the queue LQ, the first 
available server assigned to that queue processes the request. To balance the use 
of servers, PBS uses a round-robin method to determine which available server 
to use next. That is, in deciding which server to use next, the most recently used 
server is the last one PBS examines. 

You can also assign more than one queue to the same server. For example, 
suppose a batch queue named BAO is currently assigned to batch server BAO:, 
while batch queue BA1 is assigned to batch server BA1:. If you notice that queue 
BAO has many entries waiting for processing while queue BA1 is empty, you can 
assign queue BAO to both servers. Figure 9—3 shows this configuration. 


9-4 Managing Print/Batch Services 



















Figure 9-3: Many-to-One Configuration 


Queue BAO 

| Server BAO: 


Queue BA1 | 

| Server BA1: 


Note that in Figure 9—3 entries on queue BA1 are processed only by server BA1:, 
while entries on queue BAO are processed by either server. 

The combination of a one-to-many and a many-to-one configuration is a many- 
to-many configuration. That is, you can assign any set of queues to any set of 
servers. Thus, you have complete control over allocating resources (servers) for 
processing queue entries. 

You can use the SHOW QUEUE/FULL command to display the servers assigned 
to a queue. You can use the SHOW SERVER/FULL command to display the 
queues assigned to a server. The ASSIGN/QUEUE and DEASSIGN/QUEUE 
commands let you assign and deassign queue servers. 


9.1.1.5 Queue Priorities 

You assign each queue a maximum priority and default priority in the range 1 
to 255. The maximum priority of a queue defines the maximum priority a user 
can specify when issuing a request for that queue. The default priority of a queue 
defines the priority to assign to a request issued with no explicit priority specified. 
These two parameters let you set up queues so PBS processes all requests in one 
queue ahead of all requests in another queue. 

Users with EXQTA privilege can submit PRINT or BATCH requests with a 
priority greater than the queue maximum. See the section "Processing Requests" 
for more information on processing order. 


9.1.1.6 Opening and Closing Queues 

Normally, a queue accepts entries even if no servers are available to process the 
requests. At times, you may want to prevent PBS from placing any additional 
requests on a queue. This is called closing a queue; existing entries continue 
moving toward the front of the queue (if there are servers available to process 
them), but the queue does not accept additional entries. You can close a queue 
with the CLOSE/QUEUE command. 

If a user issues a PRINT or SUBMIT command for a closed queue, PBS re¬ 
turns an error and rejects the request. You can open a closed queue with the 
OPEN/QUEUE command. 


9.1.1.7 Starting and Stopping Queues 

Entries move toward the head of a queue, and PBS processes them when they 
reach the head of the queue. You can stop a queue with the STOP/QUEUE 
command to prevent any entries on the queue from being processed. Users can 
place additional entries on a stopped queue, but PBS does not process them. Any 
entries currently in process when you stop a queue are not affected. You can 
restart a stopped queue with the START/QUEUE command. 
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Note the distinction between stopping a queue and stopping a server assigned to 
a queue. When you stop a queue, PBS does not process any pending entries on 
that queue. When you stop a server, PBS does not process any pending entries 
on any queue assigned to that server. The two cases are similar in the one-to-one 
configuration. However, the two cases are quite different in a many-to-many 
configuration. 

For example, if you assign both queues A and B to the same server, stopping 
queue A does not cause that server to become idle, since processing can still 
continue from queue B. However, if you stop the server, then processing stops on 
both queues. 


9.1.1.8 Processing Requests 

In the one-to-one or one-to-many configurations, PBS always processes the entry 
at the head of the queue. However, when you assign multiple queues to the same 
server, there is no implied order to processing entries; all of the entries at the 
front of each queue are, by definition, eligible for servicing. PBS resolves any 
conflicts that occur by checking the priority and age of the entries. 

When several entries are waiting for processing, PBS chooses the one with the 
highest priority. If several entries have the same priority, then PBS selects the 
one with the earliest entry date and time. 

Before PBS can process an entry, it must be in the READY state. This means 
that the entry: 

• Is not in an AFTER state. An entry can be given an ‘after' date and time 
value, which prevents the entry from being processed until the specified date 
and time has passed. 

• Is not in a HOLD state. An entry can also be prevented from being processed 
until an operator or the entry’s owner explicitly releases it. 

• Is not in a FORMS_WAIT state. If a print entry is not on HOLD and does 
have an AFTER time, it is in a FORMS_WAIT state unless there is a server 
with the entry’s required forms installed on it. 

Once an entry is in the READY state, PBS processes it as soon as all of the 
following conditions are met: 

• PBS cannot process any other READY entries of the same type but with a 
higher priority. 

• PBS cannot process any other READY entries of the same type and the same 
priority but with an earlier entry date and time. 

• A server assigned to the entry’s queue is available to process the entry. That 
is, the server is not currently processing any other entry. 

• For print entries, a server’s controlled device is not currently allocated or 
opened by any other job on the system. 

• For batch entries, at least one pseudo keyboard of the proper type (static or 
dynamic, as appropriate to the server) is currently available to the server 
(that is, not allocated to or opened by another job on the system). 

When all of the above conditions are met, PBS starts a print or batch job on 
behalf of the entry. PBS changes the entry’s state to STARTED, and records the 
name of the server processing the job in the entry. Use the SHOW ENTRY/FULL 
command to display this information when an entry is in process. 
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Since PBS always processes print entries and batch entries by different servers, 
entries of a different type never compete with each other for processing. 


9.1.1.9 Accessing Entries on a Queue 

Users must also be able to locate entries in a queue. PBS provides two methods 
for accessing entries in queues: 

• Entry number—When PBS adds an entry to a queue as a result of the PRINT 
or SUBMIT command, PBS assigns a unique entry number to it. Entry 
numbers are unique across all queues, regardless of type. Thus, each entry 
has a specific number assigned to it, whether it is in a print queue or a batch 
queue. PBS uses this number to record the entry in its queue file. 

• Entry specification—You can also access an entry by identifying some or all of 
the following attributes: 

— The name of the entry’s queue 

— The PPN of the entry’s owner 

— The name of the entry 

These attributes are permanently established when you create the entry; they 
cannot be modified once PBS adds the entry to its queue. 

Several commands (for example, DELETE/ENTRY and SHOW ENTRY) let 
you identify an entry or group of entries by specifying an entry specification 
parameter with the command. The format of an entry specification is: 

queue-name :[PPN]entry-name 

Unlike entry numbers, entry specifications do not uniquely identify an entry; 
several entries with the same attributes can exist at the same time. Therefore, 
be careful when using entry specifications with commands to modify or delete 
queue entries, since doing so can cause multiple entries to be modified or deleted 
inadvertently. 


9.1.1.10 Job Limits for Queues 

Each queue has maximum and default limits associated with it. For print jobs, 
you can define page limits; for batch jobs, you can define both CPU and elapsed 
time limits. The servers assigned to the queue enforce these limits. 

This arrangement lets you set up queues that do not accept requests requiring 
many resources. For example, you could assign a low maximum page.limit to 
a queue assigned to a server controlling a slow-speed printer, thus restricting 
requests to relatively small print jobs. Similarly, a queue assigned to a batch 
server running jobs at low priority could accept requests that include large CPU 
or elapsed time limits. 

Users with EXQTA privilege can submit print or batch requests with job limits 
that exceed the maximum limits defined for the queues on which their requests 
are placed. 


9.1.2 Print Servers 

Each print server must have a unique name. PBS always names print servers 
after the devices they control. (For example, server LPO: controls device _LP0:, 
server KB45: controls device _KB45:, and so on.) 
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Some commands permit wildcard print server names. For example: 

• *: — Means all servers 

• LP*: — Means all LP-type servers 

• KB*: — Means all KB-type servers 

PBS does not allow the question mark character (ASCII 63) in print server 
names. 

PBS associates each entry on a print queue with a form name. This name 
identifies the form that you must install on a printer before the server controlling 
that device can start the job. If you issue a PRINT command and do not specify 
a form name, PBS assigns the form set up as the default for the queue on which 
the request is placed. 


9.1.2.1 Device Ownership 

A print or batch server can retain ownership of its controlled device and prevent 
other jobs on the system from accessing the device. Use the /NOSHAREABLE 
qualifier with the INITIALIZE/SERVER and SET SERVER commands to indicate 
that the server’s device should be permanently allocated to PBS. A device so 
allocated will be deallocated under any of the following conditions: 

• An operator changes the server’s NOSHAREABLE setting to SHAREABLE 

• The device’s server is deleted 

• PBS is shut down 

When PBS restarts after a shut down, it attempts to allocate any device whose 
server is marked as NOSHAREABLE. PBS continues to try allocating any device 
that is in use by another job on the system. PBS places such a server in the 
DEVICE-WAIT state indicating that the server is trying to gain access to the 
device. 

If you initialize a server with NOSHAREABLE and its device is not available, 
PBS displays a warning message. PBS allocates the device as soon as it becomes 
available. 

The /SHAREABLE qualifier indicates that the device can be shared by other jobs 
on the system, and PBS allocates it only when the server starts processing a 
request. For a batch server, /SHAREABLE also means the server uses a dynamic 
pseudo keyboard, while /NOSHAREABLE means a static pseudo keyboard. The 
default is /SHAREABLE. 


9.1.2.2 Job Copies and File Copies 

Each print job consists of one or more files to be printed. Qualifiers are available 
with the PRINT command to specify the number of job or file copies to be printed. 

The /JOB_COUNT=n command qualifier specifies the number of copies of the job 
to be printed. The /COPIES=n qualifier specifies the number of copies of a file to 
be printed. The default for both qualifiers is one copy. 

If a print job consists of a single file, then the two qualifiers produce the same re¬ 
sult except for the header pages (see the next section "Header Pages"). However, 
if a print job consists of more than one file, then the qualifiers produce different 
results. 
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For example, if you issue the following command: 
$ PRINT/COPIES=2 FILE1.LST,FILE2.LST 
the order of the job output is: 

Job header (1 of 1) 


File 

header 

(1 

of 

2) 

FILE1 

.LST 




File 

end 




File 

header 

(2 

of 

2) 

FILE1 

.LST 




File 

end 




File 

header 

(1 

of 

2) 

FILE2 

: .LST 




File 

end 




File 

header 

(2 

of 

2) 


FILE2.LST 
File end 


But, if you issue the following command: 

$ PRINT/JOB_COUNT=2 FILE1.LST,FILE2.LST 

the order of the job output is: 

Job header (1 of 2) 

File header (1 of 1) 

FILE1-LST 
File end 

File header (1 of 1) 

FILE2.LST 
File end 

Job header (2 of 2) 

File header (1 of 1) 

FILE1.LST 
File end 

File header (1 of 1) 

FILE2.LST 
File end 


9.1.2.3 Header Pages 

You can print special job and file header pages to identify the start of a job or a 
file within a stack of listings. Header pages include large block letters to help you 
locate the beginning of job and file copies. You can control the number of job or 
file header pages printed by the JOB_PAGES=n and FLAG_PAGES=n attributes 
of the printer form. 

Header pages consist of fields printed in single-height and double-height block 
letters and other information printed in six repeated lines. Three lines are 
printed at the top and bottom of each header page. These lines help you find the 
start of each job in a large listing. 

The job header pages contain the following information: 

• Owner’s account name — This field is in single-height block letters 

• Entry name — This field is in double-height block letters 

• Owner’s PPN — This field is in single-height block letters 

• The three lines at the top and bottom of each job header page contain the 
following: 


Current date 
Current time 
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— Entry entry-spec 

— Copy nnn of mmm 

— Printer device-name 

— Form form-name 

— Installation-name 

The file header pages contain the following information: 

• Device name and PPN — This field is in single-height block letters 

• Filename — This field is in double-height block letters 

• File type — This field is in double-height block letters 

• Owner’s PPN — This field is in single-height block letters 

• The three lines at the top and bottom of each file header page contain the 
following: 

— Current date 

— Current time 

— File filespec 

— Copy nnn of mmm 

— Printer device-name 

— Form form-name 

— Installation-name 


9.1.2.4 Page Limits 

You can limit each print job to a specified maximum number of pages. The page 
limit can be: 

• User specified 

• The default for the queue 

• Unlimited 

Print servers count the number of pages they print. When a print job exceeds its 
page limit, PBS prints an error on the last page of the job listing and terminates 
the job. Note that header pages do not count toward a job page limit. 

When the user specifies the page limit, the value cannot exceed the maximum 
limit for the queue. If the user does not specify the page limit, PBS uses the 
default limit of the queue. 


9.1.2.5 Control Characters and Escape Sequences 

Some printers, such as the LN01, LN03, and LA2xx, can understand escape 
sequences. In some cases, the action taken in response to a particular escape 
sequence is device dependent. Therefore, you must route files that contain escape 
sequences to the correct server. This is best done by providing queues that assign 
jobs only to single servers or to servers that all serve the same type of printer. 
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The /CONTROLS qualifier, provided with the INITIALIZE/SERVER and SET 
SERVER commands, indicates how the server should process control characters 
and escape sequences: 

• /CONTROLS — Indicates that the server sends control characters and escape 
sequences to its controlled device. The action taken is dependent on the 
device’s handling of such characters. The print server does not update the 
form’s current horizontal and vertical position when sending such characters 
to the printer. 

• /CONTROLS=UP_ARROW — Indicates that the server translates control 
characters to an ‘up arrow’ format, consisting of a circumflex ( A ) character 
followed by a printable character that identifies the control character, and 
that the server translates the ESC character to the dollar sign ($), causing 
PBS to display all of the characters in the escape sequence. This is the 
default. 

• /NOCONTROLS — Indicates that the server does not process control charac¬ 
ters or escape sequences. PBS discards any such characters. 

NOTE 

Control characters and escape sequences can cause a print server to 
lose track of line and page positioning. This is because print servers 
do not know what action is taken by the printer in response to such 
characters. Normally, form feed characters correct positioning within 
a file unless the server is doing simulated form feed handling. In such 
cases, it may be necessary manually to adjust the printer alignment to 
correct positioning errors introduced by control characters and escape 
sequences. 

Digital recommends that servers processing control characters always use forms 
with the NOSIMULATE attribute, to prevent positioning errors between jobs. 


9.1.2.6 Eight-Bit Characters 

PBS passes eight-bit characters unchanged to printers designated as eight-bit 
devices with the SET PRINTER/EIGHTJ3IT or SET TERMINAL/EIGHT.BIT 
commands. 

For seven-bit devices, PBS converts eight-bit control characters to their seven-bit 
equivalents. For example, <CSI> becomes <ESC>[. PBS does not handle eight-bit 
printable characters; they are truncated to seven bits as they pass to seven-bit 
devices. 


9.1.2.7 Using Serial Printers with PBS 

If a serial terminal used as a printer is powered off when the system is booted, 
the device appears to the system to be operational. If a user tries to print a file 
on the terminal, the system sends characters to the device at the usual speed 
and assumes they are being printed properly. Obviously, since the device is 
powered off, the characters are not being printed, but the device cannot return 
any indication of that fact to the system. The entire file is sent as if it were 
printing. 

If a spooler is started on such a KB: line, any files queued to that spooler are 
sent, just as if the device were printing properly. The queue gradually empties, 
and any files queued with /DELETE are deleted. 
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Since, under these circumstances, there is no method by which the software can 
differentiate between a terminal that is powered off and one that is printing 
properly, Digital recommends that the person starting up a RSTS/E system check 
to ensure that all terminal devices that are ordinarily spooled are powered on and 
properly online before system startup is performed. 

Most serial printers send an XOFF character to the system when they are 
turned off or taken offline, and send an XON when power is turned back on or 
the printer is put online. If the serial printers are online when timesharing is 
started, RSTS/E correctly responds to these XOFF and XON characters and stalls 
output to the printer accordingly. 


NOTE 

The LA180S serial printer has other special characteristics, which are 
discussed in the RSTS/E Maintenance Notebook . 


9,1.3 Batch Servers 

Batch servers are named BAn:, where n is a unit number in the range 0-31. 
Some commands permit wildcard batch server names, for example: 

• *:—Means all servers 

• BA*:—Means all batch servers 

PBS does not allow the question mark character (ASCII 63) in batch server 
names. 


9.1.3.1 Executing Command Files 

Batch servers use the DCL command file processor on pseudo keyboards to create 
the batch job environment. Batch servers execute a batch job by creating a 
temporary command file. This file: 

• Opens a log file (unless the you specify /NOLOGJFILE with the SUBMIT 
command) 

• Initializes error handling 

• Executes LOGIN.COM files 

• Turns VERIFY on 

• Executes the individual user command files 

PBS passes the parameters you specify with the SUBMIT command only to the 
first command file in the batch job. 

Because batch servers create their own command procedure to execute the user’s 
command files, the number of levels of command nesting that PBS allows is 
one less than the levels available when executing command procedures at the 
interactive level (see RSTS/E Guide to Writing Command Procedures ). 

The exit status that PBS reports in the batch log file is the status of the most 
severe error occurring in the job, not just the last one. The format of the exit 
status display is: 

Exit status = )<message 
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Table 9-2 lists the possible exit status messages. 


Table 9-2: PBS Batch Job Exit Status Messages 


Message 

Meaning 

Entry deleted 

Job was deleted during processing 

Error 

An error message occurred in the job, but no severe errors 
occurred 

Exceeded CPU limit 

Job exceeded the CPU time limit 

Exceeded time limit 

Job exceeded the time limit 

Severe error 

A severe error message occurred in the job 

Success 

No errors or warnings encountered 

Unknown 

Job logged out or was killed (exit status is unknown) 

Warning 

A warning message occurred in the job, but no errors occurred 


9.1.3.2 CPU and Time Limits 

Batch servers also monitor their batch jobs to enforce CPU and time limits and 
determine when the job is done. An active batch server examines its controlled 
job’s CPU and time usage approximately every 30 seconds. If either value exceeds 
the allowable limit for the batch job, PBS terminates the job immediately. If you 
specify a log file with the SUBMIT command, PBS includes an error message in 
the log describing the reason for the job termination. 


9.1.4 Managing Forms for PBS 

Printer forms are the physical paper you install in a line printer. In some cases, 
forms are standard stock paper as normally used for printing program listings. In 
other cases, forms are customized, preprinted paper, such as checks or invoices. 

PBS identifies each form by name. A form name consists of 1-9 characters from 
the set {A-Z, 0-9, $, _}. PBS converts lowercase characters to uppercase. 

When you define a print server, you can specify the name for the form currently 
installed on the server’s print device. Each form definition includes the form 
handling characteristics for the printer to which it applies. A Forms Definition 
File (FDF), maintains all the form characteristics for each server in PBS (see the 
next section). 

When you issue a print request, you can specify the form name required using the 
/FORMS=form-name qualifier. If you do not include a form name, PBS assigns 
the queue default form name to the print request. PBS verifies that the specified 
form name is in the FDF. If not, PBS returns an error and rejects the print 
request. 

Before PBS can start a print request, a server assigned to the request’s queue 
must be available with the required form installed on its printer. If not, the 
request remains READY until you change forms or until you assign a new server 
with the correct form name to the request’s queue. 

You can define the same form name differently for different printers. For 
example, NORMAL can have different characteristics for the printer LPO: 
from those it has for LP1:. Generally, the physical dimensions of a form page 
(length and width) should remain the same from one printer to another, but the 
attributes that describe how a printer should handle the form may be different, 
depending on the device. 
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9.1.4.1 


Forms Attributes 


PBS defines the following attributes for printer forms: 

• Form name — A unique 1 to 9 character name that identifies the form. 

• Server name — The name of the server to which the form definition applies. 
This can refer to a single server or multiple servers of the same type (LP or 
KB). 

• Length — The physical length of a form page, measured in lines of print. 

This value can be in the range 1 to 255. 

• Width — The width of a form page, measured in characters printed across the 
page. The value can be in the range 1 to 255. 

• Job pages — The number of header pages to print at the start of each new 
print job. The value can be in the range 0 to 127. 

• Flag pages — The number of flag pages to print at the start of each new file 
within a print job. The value can be in the range 0 to 127. 

• Form-feed handling — Depending on the form page length and the hardware 
capability, the printer may or may not be able to correctly handle FF charac¬ 
ters that position the form page at the top of the next page. If not, then the 
server must simulate the form feed action by outputting the proper number of 
line feeds to reach the top of the next page. 

• Bottom margin — The number of lines to skip at the bottom of each page. 
The value must be less than the form page length. 

• Trailer pages — Determines whether or not a single trailer page prints per 
file. 


9.1.4.2 The Forms Definition File 

PBS provides a Forms Definition File (FDF) to maintain all printer form defini¬ 
tions. This file is a standard ASCII stream file, allowing anyone with write access 
to add, delete, and update the form definitions using a standard text editor. FDF 
defines form attributes by using keywords (for example, LENGTH=66), to simplify 
definitions further. 

PBS treats lines beginning with an exclamation point (!) as comment lines. Thus, 
you can include descriptions in the definitions file. 

PBS also supports continuation lines. If a definition ends with a hyphen (-), 
the definition is continued on the next line similar to the DCL command line 
continuation feature (see the RSTS/E System User's Guide). 

NOTE 

If a line to be continued contains a comment, the hyphen must precede 
the comment (see the next section "Forms Definition Keywords"). 

Blank lines are ignored. So, you can include blank lines where you 
want to separate definitions for readability. 

The name of the Forms Definition File supplied on the RSTS/E distribution kit is 
PBS$:FORMS.SYS. As distributed, this file contains two definitions for the form 
named NORMAL: one is for LP-class printers and one is for KB-class printers. 
The file has a protection code of <40>, allowing any user on the system to read it; 
however, only users with WWRITE privilege can write to it. 
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The default print queue SYS$PRINT is initially set up with NORMAL as its de¬ 
fault form name. After you install PBS, you can change any of these parameters. 
You can add additional definitions to the file as needed. 

The order of form definitions in the FDF is significant. If yon initialize a print 
queue and you do not include the /FORMS qualifier, PBS defaults to the first form 
definition. Similarly, if you define a print server and do not include the /FORMS 
qualifier, PBS defaults to the first form definition that applies to that server. 

PBS accesses the FDF for the following reasons: 

• When you include a /FORMS qualifier with the PRINT command, PBS 
searches the FDF for the specified form name. 

• When you issue a INITIALIZE/SERVER or SET SERVER command that 
includes a /FORMS qualifier for a print server, PBS searches the FDF for the 
definition of the specified form name. 

• When you issue a INITIALIZE/QUEUE or SET QUEUE command that 
includes a /FORMS qualifier for a print queue, PBS searches the FDF for the 
specified form name. 

If the form name is not found, then PBS returns an error and rejects the request. 


9.1.4.3 Forms Definition Keywords 

A forms definition consists of: 


• Form name 

• Server name 

• One or more keywords that describe the form attributes 

You can use spaces or tabs to separate the keywords within a form definition. 
Any standard RSTS/E line terminator (CR, LF, FF) terminates each definition. 
For example, the definition of the default form named NORMAL for LP-class 
servers is: 


NORMAL=_LP*:- 

LENGTH=66- 

WIDTH=132- 

JOB_PAGES=2- 

FLAG_PAGES=2- 

BOTTOM_MARGIN=6- 

TRAILERJPAGES- 

NOSIMULATE 


! form NORMAL for all LP servers 
! 66 lines per page 

! 132 columns per line 
! 2 job header pages 
! 2 flag header pages 

! 6 blank lines at the bottom of each page 

! trailer pages 
! hardware top-of-*form 


If a forms definition applies to a particular server, or class of servers, the server 
name follows the form name and is separated from it by an equal sign. The 
format of the server name in a forms definition is: 


form-name[=server-name[:]] 


PBS does not permit embedded spaces or tabs between the form name and the 
server name. 

The server-name identifies the server(s) to which this definition applies. If the 
definition only applies to a single server, then specify the explicit server name. If 
the definition applies to a class of servers (all LP or all KB devices), then specify 
form-name=_LP*: or form-name=_KB*: (wildcard unit number). If the definition 
applies to all print servers, then specify form-name=*: or omit this field from the 
definition. The default is all servers. 
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NOTE 


If a server belongs to more than one definition for the same form, place 
definitions that apply to specific servers before any that apply to a 
general class of servers. PBS searches the FDF sequentially until it 
finds the first occurrence of the requested form name with a matching 
server name. 

You can abbreviate all forms definition keywords to their first two characters. 
Note that the form name always appears first in the definition and has no 
associated keyword. All other fields in the definition can be in any order. If a 
keyword is not included in a form definition, then PBS uses the keyword default 
value. 

You can include the following keywords in a forms definition: 

LENGTH=n 

Indicates the number of lines per printed page for the specified form. The value n 
can range from 1 to 255. The default length is 66; this is standard spacing for an 
8-1/2 by 11-inch form with vertical spacing of 6 lines per inch. 

NOTE 

Some devices that print on single-sheet forms cannot print on all 
physical lines of the form. For example, the LN01 prints a maximum 
of 60 lines per page. In such cases, the form length should be set to the 
device’s maximum print lines; not the form’s physical size. 

WIDTH=n 

Indicates the maximum number of characters that can appear in a printed line 
for the specified form. The value n can range from 1 to 255. The default width is 
132. The WIDTH value determines where a printed line will be truncated (if the 
file is being printed with the /TRUNCATE qualifier of the DCL PRINT command 
in effect) or wrapped around to a new line (if the file is being printed with the 
/NOTRUNCATE qualifier in effect). 

[NO]SIMULATE 

Determines whether PBS should, on encountering a FF character or reaching 
the end of a page, send a FF character directly to the device (NOSIMULATE), or 
simulate the form feed by transmitting the proper number of line-feed characters 
(SIMULATE). The default is SIMULATE. 

JOB_PAGES=n 

Defines the number of job header pages to be printed at the beginning of each 
job listing. The value n can range from 0 to 127. Job header pages display 
information about the job (job name, PPN, and so forth), printed in large block 
letters. Job header pages make it easy to separate job listings. The default is 
JOB JPAGES=1. 

FLAG_PAGES=n 

Defines the number of file header pages to be printed at the beginning of each 
file listing. The value of n can range from 0 to 127. File header pages display 
information about the file (file name, PPN, and so forth), printed in large block 
letters. File header pages make it easy to separate printouts of files within a job. 
The default is FLAG_PAGES=1. 

NOTE 

You can suppress the printing of file header pages by including the 
/NOFLAG_PAGES qualifier with the file to be printed. 
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BOTTOM_MARGIN=n 

Defines the number of lines to skip at the bottom of each page of the form. 
The bottom margin value cannot exceed the form’s length. The default is 
BOTTOMJMARGIN=6. Printers that use single-sheet paper (for example, the 
LN01) automatically end a page and start a new page when it reaches its max¬ 
imum print line. Forms definitions for these devices should normally specify 
BOTTOMJVIARGIN=0. 

NOTE 

You can suppress the printing of the bottom margin by including the 
/NOFEED qualifier with the file to be printed. This has no effect when 
BOTTOM_MARGIN=0. 

TRAILER_PAGES 

Determines whether or not a single trailer page prints after each file. 


9.1.4.4 Changing Forms 

Whenever you need to change forms on a printer under the control of PBS, 
perform the following steps: 

1. Use the STOP/SERVE R/JOB_END command to stop the server at the end of 
any current print job. 

2. Use the SHOW SERVER command to confirm that the server is stopped and 
is not processing any print job. 

3. Install the desired form in the printer. 

4. Use the SET SERVER/FORMS=form-name command to assign a new form 
name to the server. Use the SHOW SERVER/FULL command to inspect the 
new form attributes (LENGTH, WIDTH, and so on) as needed. 

5. Use the START/SERVER command to restart the server. When you issue 
this command, PBS routes any jobs that are waiting for the new form to be 
installed to the server. 

Note that you can issue a SET SERVER/FORMS=form-name command without 
stopping the server, although Digital does not recommended this unless the 
new form definition applies to the same physical form currently installed in the 
printer. Any print job in progress at the time its print server is assigned a new 
form name is not affected. The form name last assigned to the server determines 
the next job to be processed by the server. Use the SHOW SERVER command to 
display the name of the form most recently assigned. 

If you modify the FDF to change the definition of a form name which is currently 
assigned to a server, you must perform a form change (using the same form name) 
to cause the new form definition to be read from the FDF. 


9.2 Multiple Jobs 

PBS consists of a single primary job and, optionally, one or more secondary jobs, 
depending on the number and use of concurrent print or batch servers. PBS is 
designed to provide a compact and efficient package across all of its jobs. This 
section provides some background information on how the PBS package makes 
use of multiple jobs. 
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9.2.1 The Primary Job 

Whenever you issue the START/QUEUE/MANAGER command, PBS creates its 
primary job. This job runs detached. It contains the queue manager module and 
is always present when the package is running. 

The primary job contains two print and two batch server slots. A slot refers to 
a sub-job in the PBS job that provides print or batch services. If the number of 
slots available to support the active print or batch servers in the primary job is 
insufficient, PBS creates secondary jobs. 


9.2.2 Secondary Jobs 

PBS creates secondary jobs when there are no print or batch server slots available 
in the primary job to process a waiting request. PBS attempts to activate only as 
many servers as necessary, depending on the number of waiting requests ready to 
run, available devices, and so on. Each secondary job contains three print server 
slots and four batch server slots. 

When PBS starts, only the primary job is running. When a pending request is 
ready to start, the queue manager first determines if a slot is available on which 
to activate a server for the request. If the primary job contains no available 
server slots of the correct type (print or batch), then PBS automatically creates a 
secondary job. 

Unlike the primary job, a secondary job remains present only while one or more 
of its server slots is allocated to a server. Once all the server slots in a secondary 
job become free (that is, there are no active servers in the job) PBS automatically 
removes the job from the system. It is possible for several PBS secondary jobs to 
be present on the system at the same time, depending on the number of active 
servers that you require at any time. 

NOTE 

PBS secondary jobs contain only print and batch server slots; they do 
not contain a queue manager module. 

Based on the configuration of PBS, the primary job is sufficient to handle two 
concurrent print jobs and two concurrent batch jobs. If more than two print or 
two batch servers are active at the same time, then PBS creates at least one 
secondary job. Each secondary job allows for three more print jobs and four more 
batch jobs to be started. Thus, if your printing volume causes six print devices 
to be active concurrently, you need a total of three RSTS/E jobs (one primary and 
two secondary) to run PBS. 

PBS uses an "idle job timer" to determine when to remove a secondary job from 
the system. PBS removes a secondary job when all of its servers have been 
idle for five minutes. This time is sufficient for PBS to start a server’s next job 
without having to recreate a secondary job. 

PBS creates secondary jobs as needed, as long as job slots are available on the 
system. If none are available, then no secondary job is created, and PBS waits 
until either a job slot becomes available, or an existing server slot becomes free. 

You can limit the number of secondary jobs required by controlling the number 
of servers that can process requests. You can do this by deassigning or stopping 
one or more servers. Idle servers that are stopped or not assigned to any queue 
cannot process a request. Thus, they do not require a server slot. 
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9.3 DCL Command Descriptions 

The following sections contain descriptions of the PBS commands that require 
special privileges. See the RSTS/E System User's Guide for descriptions of 
PRINT, SUBMIT, DELETE/ENTRY, SET ENTRY, SHOW ENTRY, and SHOW 
QUEUE commands. 


9.3.1 ASSIGN/QUEUE Command 


This command assigns a server to a queue. Server assignments are cumulative; 
any server assigned to a queue is added to the set of assigned servers. A server 
named BAn: can only be assigned to a batch queue. Likewise, a server named 
LPn: or KBn: can only be assigned to a print queue. ASSIGN/QUEUE requires 
PBSCTL privilege. 


Format 

ASSIGN/QUEUE queue-name[:] server-namef:] 

Command Qualifiers 
none 

Prompts 

Queue: queue-name[:] 

Server: server-name[:] 


Command Parameters 

queue-name[:] 

Specifies the name of the queue to be assigned. This command does not permit 
wildcard queue names. 

server-name[:] 

Specifies the server to assign to the queue. This command does not permit 
wildcard server names. 
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9.3.2 CLOSE/QUEUE Command 


This command closes a queue; that is, it prevents any additional requests from 
being placed on the queue. If the specified queue is not open, RSTS/E ignores this 
command. CLOSE/QUEUE requires PBSCTL privilege. 


Format 

CLOSE/QUEUE queue-name[:] 

Command Qualifiers 
none 

Prompts 

Queue: queue-name[:] 


Command Parameters 

queue-name[:] 

Specifies the name of the queue to be closed. This command does not permit 
wildcard queue names. 
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9.3.3 DEASSIGN/QUEUE Command 


This command deassigns a server from a queue. Any job already started on a 
deassigned server is not affected. However, no additional jobs are started on the 
server from the queue. DEASSIGN/QUEUE requires PBSCTL privilege. 


Format 

DEASSIGN/QUEUE queue-name[:] server-name[:] 

Command Qualifiers Defaults 

/ALL See Discussion 

Prompts 

Queue: queue-name[:] 

Server: server-name[:] 


Command Parameters 

queue-name[:] 

Specifies the name of the queue to be deassigned. This command does not permit 
wildcard queue names. 

server-name[:] 

Specifies the name of the server to be deassigned. This parameter overrides the 
/ALL qualifier. This command does not permit wildcard server names. 

Command Qualifiers 

/ALL 

Indicates that all servers currently assigned to the queue should be deassigned. 
If you specify /ALL, PBS does not prompt for a server name. If you specify a 
server name, PBS ignores /ALL. 
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9.3,4 DELETE/QUEUE Command 


This command deletes a queue. If you issue DELETE/QUEUE for a queue that 
has one or more entries, RSTS/E marks the queue for deletion and closes it. 
PBS deletes the queue as soon as it becomes empty. You can still display queues 
marked for deletion using the SHOW QUEUE command. DELETE/QUEUE 
automatically deassigns all servers from the deleted queue. DELETE/QUEUE 
requires SWCFG privilege. 


Format 

DELETE/QUEUE queue-name[:J 

Command Qualifiers 
none 

Prompts 

Queue: queue-name[:] 


Command Parameters 

queue-name[:] 

Specifies the name of the queue to be deleted. This command does not permit 
wildcard queue names. 
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9.3.5 DELETE/SERVER Command 


This command deletes a print or batch server. If the server you specify is cur¬ 
rently processing a job when you issue the command, RSTS/E marks it for dele¬ 
tion. PBS deletes the server when it becomes idle. DELETE/SERVER automat¬ 
ically deassigns the deleted server from all assigned queues. DELETE/SERVER 
requires SWCFG privilege. 


Format 

DELETE/SERVER server-name[:] 

Command Qualifiers 
none 

Prompts 

Server: server-name[:] 


Command Parameters 

server-name[:] 

Specifies the name of the server to be deleted. This command does not permit 
wildcard server names. 
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9.3.6 INITIALIZE/QUEUE Command 


This command defines a print or batch queue and establishes its initial proper¬ 
ties. Use the SHOW QUEUE command to display the queues that are currently 
defined. See the RSTS/E System User’s Guide for details on the SHOW QUEUE 
command. 

When you initialize a queue, you also define its characteristics. Print and batch 
queues have different characteristics. You can modify any of a queue’s character¬ 
istics later by using the SET QUEUE command. 

Note that certain qualifiers for this command apply only to print queues, while 
others apply only to batch queues. An error results if you include both types of 
qualifiers in the same command. PBS uses the following criteria to determine 
whether a queue should be initialized as a print queue or a batch queue: 

If you give a /PRINT or /BATCH qualifier, it determines the queue’s type. 

• If you do not give either /PRINT or /BATCH, but you specify a print queue 
only qualifier (for example, /PAGE_LIMIT) or a batch queue only qualifier (for 
example, /CPU_LIMIT), that qualifier determines the queue’s type. 

If you do not meet either of the previous conditions, the queue’s type defaults 
to a print queue. 

PBS retains queue information in the queue file when the package is shut down. 
The system uses this information to automatically reinitialize queues when it 
restarts the package. INITIALIZE/QUEUE requires SWCFG privilege. 


Format 


INITIALIZE/QUEUE queue-name[:] 

Command Qualifiers 

/BATCH 

/CLOSE 

/CPU_LIMIT=(MAXIMUM=a,DEFAULT=b) 

/CPU_LIMIT=n 

/DEFAULT 

/FORMS=form-name 

/PAGE_LIMIT=(MAXIMUM=a,DEFAULT=b) 

/PAGE_LIMIT=n 

/PRINT 

/PRIORITY=(MAXIMUM=a,DEFAULT=b) 

/PRIORITY=n 

/PRIVILEGES=(priv[,...]) 

/TIME_LIMIT=(MAXIMUM=a,DEFAULT=b) 

/TIME_LIMIT=n 

Prompts 

Queue: queue-name[:] 


Defaults 

See Discussion 
See Discussion 
See Discussion 
See Discussion 
See Discussion 
See Discussion 
See Discussion 
See Discussion 
See Discussion 
See Discussion 
See Discussion 
/PRIVILEGES=NONE 
See Discussion 
See Discussion 
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Command Parameters 

queue-name[:] 

Specifies the name of the queue to be initialized. This command does not permit 
wildcard queue names. 

Command Qualifiers 

/BATCH 

Indicates that the queue is a batch queue, and only accepts entries the SUBMIT 
command. 

/CLOSE 

Indicates that the queue should initially be closed, preventing any PRINT or 
SUBMIT entries from being entered on the queue. By default, PBS initializes the 
queue as open. 

/CPU_LIMIT=(MAXIMUM=a,DEFAULT=b) 

/CPU_LIMIT=n 

Batch queues only. Indicates the maximum and default CPU time limits (in 
minutes) for each command file processed in a batch job started from this queue. 
The maximum CPU limit is the largest value that you can specify when issuing 
a request for the queue. The default CPU limit is the value that PBS assigns 
to a request that had no limit specified. The keyword UNLIMITED indicates 
that PBS does not enforce a CPU limit. If you do not specify the MAXIMUM 
argument, then PBS uses MAXIMUM=UNLIMITED. If you do not specify the 
DEFAULT argument, then PBS uses the maximum CPU limit as the default 
limit. 

If you use the /CPU_LIMIT=n form, then PBS uses the value you specify for both 
the maximum and default limits. If you specify a numeric argument, it must be 
in the range 1 to 65,535. The default CPU limit cannot exceed the maximum 
CPU limit. 

If you issue a SUBMIT command without an explicit CPU limit, then PBS uses 
the queue default CPU limit. When you issue a SUBMIT command, you can 
specify a CPU limit up to, but not exceeding the queue maximum CPU limit. 

/DEFAULT 

Indicates that the queue should be marked as the default queue for its type (print 
or batch). You can define only one print queue and one batch queue as a default 
queue. 

If you specify /DEFAULT, then the queue becomes the default queue for its type, 
and any queue currently defined as the default queue of the same type no longer 
serves as the default queue. By default, PBS does not mark the queue as a 
default queue. 

/FORMS=form-name 

Print queues only. Indicates if a default form name is defined for the queue. 

If you specify /FORMS=form-name, then PBS defines the name you specify as 
the default form name for the queue. If you issue a PRINT command without 
a /FORMS qualifier, then the queue’s default form name is the first form name 
found in the FDF. 
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/PAGE_LIMIT=(MAXIMUM=a,DEFAULTS) 

/PAGE_LIMIT=n 

Print queues only. Indicates the maximum and default page limits for each file 
printed as part of a print job started from this queue. The maximum page limit 
is the largest value that you can specify when issuing a PRINT request for this 
queue. The default page limit is the value assigned to a request for this queue 
that had no limit specified. 

The keyword UNLIMITED indicates that no page limit is enforced. If you do not 
specify the MAXIMUM argument, then PBS uses MAXIMUM=UNLIMITED. If 
you do not specify the DEFAULT argument, then PBS uses the maximum page 
limit as the default limit. 

If you use the /PAGE_LIMIT=n form, then PBS uses the value you specify for 
both the maximum and default limits. If you specify a numeric argument, it must 
be in the range 1 to 4,294,967,295. The default page limit cannot exceed the 
maximum page limit. 

If you issue a PRINT command without an explicit page limit, then PBS uses the 
queue default page limit. When you issue a PRINT command, you can specify a 
page limit up to, but not exceeding, the maximum page limit of the queue. 

/PRINT 

Indicates that the queue is a print queue and only accepts entries from the 
PRINT command. 

/PRIORITY=(MAXIMUM=a, DEFAULTS) 

/PRIORITY=n 

Defines the maximum and default priorities for the queue, in the range 1 to 255. 
If you do not specify the MAXIMUM argument, then PBS uses 255. If you do 
not specify the DEFAULT argument, then PBS uses the maximum value as the 
default priority. If you use the /PRIORITY=n form, then PBS uses the value you 
specify for both the maximum and default priority. The default priority cannot 
exceed the maximum priority. 

/PRIVILEGES=(priv[,...]) 

Specifies the set of privileges required for a user to place entries on the queue. 

A user who issues a PRINT or SUBMIT command must have all of the queue’s 
privileges for the request to be accepted. By default, a user does not need any 
privileges to place an entry on the queue. 

The argument can be any of the RSTS/E privilege keywords, plus the keywords 
ALL and NONE. The /PRIVILEGES=ALL qualifier assigns all defined privileges 
to the queue; /PRIVILEGES=NONE assigns no privileges to the queue. Note that 
you can specify any privilege name with /PRIVILEGES, even those that you do 
not possess. 

The argument can also be IJSERn, where n is an integer between 1 and 8. You 
can use these USERn privileges to identify particular users or groups of users 
and to restrict the queue’s usage to those users. 

/TIME_LIMIT=(MAXIMUM=a,DEFAULT=b) 

/TIME_LIMIT=n 

Batch queues only. Indicates the maximum and default elapsed time limits (in 
minutes) for each command file processed in a batch job started from this queue. 
The maximum time limit is the largest value that you can specify when issuing a 
request for this queue. The default time limit is the value that PBS assigns to a 
request that had no limit specified. 
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The keyword UNLIMITED indicates that PBS does not enforce a time 
limit. If you do not specify the MAXIMUM argument, then PBS uses 
MAXIMUM=UNLIMITED. If you do not specify the DEFAULT argument, 
then PBS uses the maximum time limit as the default limit. If you use the 
/TIME_LIMIT=n form, then PBS uses the value you specify for both the maxi¬ 
mum and default limits. If you specify a numeric argument, it must be in the 
range 1 to 65,535. The default time limit cannot exceed the maximum time limit 
of the queue. 

If you issue a SUBMIT command without an explicit time limit, then PBS uses 
the queue default time limit. When you issue a SUBMIT command, you can 
specify a time limit up to, but not exceeding, the maximum time limit of the 
queue. 
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9.3.7 INITIALIZE/SERVER Command 


This command defines a print or batch server. Use the SHOW SERVER command 
to display the servers that are currently defined. See the description of the 
SHOW SERVER command in this chapter for details. 

When you initialize a server, you also define its characteristics. Print and batch 
servers have different characteristics. You can modify any of a server’s character¬ 
istics later by using the SET SERVER command. 

PBS retains the server information in the queue file when the package is shut 
down. The system uses this server information to initialize servers automatically 
when you restart the package. This eliminates the need to reinitialize servers 
each time you start PBS. INITIALIZE/SERVER requires SWCFG privilege. 


Format 


INITIALIZE/SERVER server-name[:] 

Defaults 

See Discussion 
See Discussion 
/PRIORITY=-8 
/R U N_B U RST=6 
/SHAREABLE 

Prompts 

Server: server-name[:] 


Command Qualifiers 

/[NO]CONTROLS[=UP_ARROW] 

/FORMS=form-name 

/PRIORITY=n 

/RUN_BURST=n 

/[NOJSHAREABLE 


Command Parameters 

server-name[:] 

Specifies the name of the server to be initialized. This command does not permit 
wildcard server names. 

Command Qualifiers 

/[NO]CONTROLS[=UP_ARROW] 

Print servers only. Indicates how print servers should process control characters 
and escape sequences. The default is /CONTROLS=UP_ARROW (see the section 
"Control Characters and Escape Sequences"). 

You must have PBSCTL privilege to specify this qualifier. 

/FORMS=form-name 

Print servers only. Identifies the form currently installed on the printer. The 
server only prints requests with this form name. PBS displays an error message 
if the form name does not exist in the FDF. 

If you omit this qualifier, then PBS initializes the printer with the first form 
definition found in the FDF that applies to the specified print server. You can 
later issue a SET SERVER command to assign a different form to the server. 
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/PRIORITY=n 

Batch servers only. Indicates the priority at which to run command procedures 
controlled by this server. RSTS/E permits any value in the range -120 to +120; 
however, batch jobs cannot exceed the priority of the PBS primary job. RSTS/E 
rounds the priority down to a multiple of 8. The default is -8. 

You must have TUNE privilege to specify this qualifier. 

/RUN_BURST=n 

Batch servers only. Indicates the run burst to assign to any command procedures 
controlled by this server. RSTS/E permits any value in the range 1 to 127. The 
default is 6. 

You must have the TUNE privilege to specify this qualifier. 

/[NOJSHAREABLE 

Specifies if the server’s device should be shared with other jobs on the system. 
The default is /SHAREABLE. 

If you specify /NOSHAREABLE, RSTS/E immediately allocates the device to 
the PBS job, thereby preventing other jobs on the system from gaining access 
to the device. For batch servers, PBS allocates the next available static pseudo 
keyboard to the server. The device remains allocated to the PBS job until you 
delete its server (with the DELETE/SERVER command), or you shut down PBS 
(with the STOP/QUEUE/MANAGER command). You get a warning message if 
you specify /NOSHAREABLE for a device currently allocated to another job on 
the system; PBS allocates the device when it becomes available. 

If you specify /SHAREABLE, PBS allocates tbe device only when the server is 
active. The device is available to other jobs when the server is idle. The default 
is /SHAREABLE. 

For batch servers, /SHAREABLE means the server uses a dynamic pseudo 
keyboard with terminal characteristics that cannot be set; /NOSHAREABLE 
means the server uses a static pseudo keyboard, with terminal characteristics 
that can be set. Digital recommends that you use /SHAREABLE unless you need 
specific terminal characteristics. 
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9.3.8 OPEN/QUEUE Command 


This command opens a queue for additional requests after it has been 
closed. If the specified queue is already open, RSTS/E ignores this command. 
OPEN/QUEUE requires PBSCTL privilege. 


Format 

OPEN/QUEUE queue-name[:] 

Command Qualifiers 
none 

Prompts 

Queue: queue-name[:] 


Command Parameters 

queue-name[:] 

Specifies the name of the queue to be opened. This command does not permit 
wildcard queue names. 
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9.3.9 PRINT Command 


Format 


PRINT file-spec],...] 

[entry-spec] 

Command Qualifiers 

Defaults 

/AFTER=date-time 


/FORMS=form-name 

See discussion 

/HOLD 


/JOB_COUNT=n 

/JOBCOUNT=1 

/NAME=entry-name 

See discussion 

/[NOJNOTIFY 

/NONOTIFY 

/OWNER=ppn 

See discussion 

/PAGE_LIMIT=n 

See discussion 

/PAGE_LIMIT=UNLIMITED 

See discussion 

/PRIORITY=n 

See discussion 

/QUEUE=queue-name[:] 

See discussion 

File Qualifiers 

Defaults 

/[NOJCONVERT 

/NOCONVERT 

/COPIES=n 

/C0PIES=1 

/[NOJDELETE 

/NODELETE 

/[NOJFEED 

/FEED 

/[N 0] FLAG_PAG ES 

/FLAG_PAGES 

/[NOJTRUNCATE 

/NOTRUNCATE 

/[NO]WRAP 

/WRAP 

Prompts 


File: file-spec[,...] 



Command Parameters 

file-spec[,...] 

Specifies one or more files to be printed. If you specify more than one file, 
separate the file specifications with commas (,) or plus signs (+). In either case, 
the PRINT command prints all the files as a single print job. You can use 
wildcard characters for the file name, file type, and directory. 

If you do not specify a file type, the PRINT command uses the default file type 
.LST. If you do not specify a device, the PRINT command uses SY:. 

You can also specify a node name as part of the file specification. If you specify a 
file on a remote node, PBS temporarily copies the file into your account, prints it, 
and then deletes it. Note that you cannot use any qualifiers if you specify a node 
name. 

entry-spec 

The entry-spec specifies the queue and the name of the entry in the format queue- 
name:[PPN]entry-name. The entry-name can contain from one to nine characters. 
If you do not specify a queue, PBS submits the entry on the default print queue. 
If you do not specify an entry-name, PBS assigns the first nonnumeric file name 
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in the list of specified file-specs, or PRINT if none is found. Your own PPN is the 
default. 

Command Qualifiers 

/AFTER=date-time 

Requests that the file not be printed until a specific time of day or date. See 
Chapter 2 for a description of the standard syntax rules for specifying date and 
time values. 

For example, to have a file named TIBET.MEM start printing after 5:30#PM on 
September 11 (after normal working hours when there are fewer requests for 
listings), specify the date and time as: 

$ PRINT/AFTER=11-SEP:05:30PM TIBET.MEM 

If the specified date or time has already passed, the file is queued for printing as 
soon as possible. 

/FORMS=form-name 

Specifies the name of the form required for the specified file(s). You specify the 
forms type with an alphanumeric name defined by the system manager. Check 
with the system manager to learn which form names you can specify. 

/HOLD 

Specifies that the entry be placed in a HOLD state on the queue. Entries 
in a HOLD state are not processed until you release them with the SET 
ENTRY/RELEASE command. 

/JOB_COUNT=n 

Requests that the entire job be printed n times, from 1 to 255. By default, the job 
is printed once. 

The following example prints four copies of a file named AFGHAN.TXT: 

$ PRINT/JOB_COUNT=4 AFGHAN.TXT 

/JOB_COUNT differs from the /COPIES qualifier in the order in which multiple 
files are printed. For example, if you request three copies of files HOGAN.TOM 
and MARCH.ANN, the /JOB_COUNT qualifier prints one copy of HOGAN.TOM, 
followed by one copy of MARCH.ANN, and repeats the grouping until three copies 
of each file are printed: 

$ PRINT/JOB_COUNT=3 HOGAN . TOM, MARCH . ANN 

/NAME=entry-name 

Specifies the 1 through 9 character name assigned to the entry. You can display 
the entry-name with the SHOW ENTRY command. In addition, PBS prints the 
entry-name on the first page (also known as the flag, or banner, page) of the hard 
copy. 

/[NO]NOTIFY 

Specifies whether your terminal session is notified of changes to the status of the 
print entry. Messages are sent when the: 

• Entry is started 

• Entry is completed 

• Entry is deleted from its queue 

• Print server processing a print entry goes off line 

The default is /NONOTIFY. 
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/OWNER=[ppn] 

Indicates the owner of the print job. PBS displays the project-programmer 
number on the job header page. You can only specify jobs with your own PPN 
(the default), unless you have sufficient privilege to specify others. 

/PAGE_LIMIT=n 

/PAGE_LIMIT=UNLIMITED 

Specifies the maximum number of pages to be printed in the job. You can specify 
only up to the maximum page limit assigned to the queue by the system manager. 

You can specify /PAGE_LIMIT=UNLIMITED only if the queue’s maximum page 
limit is also set to UNLIMITED. 

/PRIORITY=n 

Specifies the priority of the print job, in the range 1 through 255. The PRINT 
command processes entries in priority order: higher-priority entries before 
lower-priority entries. 

You cannot specify a priority higher than the maximum priority assigned to the 
queue by the system manager. 

/QUEUE=queue-name[:] 

Specifies the name of the queue on which the entry is placed. The queue you 
specify must be a print queue. 

If you do not specify a queue-name in the entry-spec or if you do not specify 
/QUEUE, PBS places the entry on the default print queue. 

Use the SHOW ENTRY command to verify an entry’s position in the queue. 

File Qualifiers 

/[NOJCONVERT 

Specifies whether all zeros should be converted to the letter O before printing. 
The default is /NOCONVERT. 

/COPIES=n 

Specifies the number of copies to print. By default, the PRINT command prints 
one copy of a file; you can use /COPIES to request up to 255 copies. For example, 
the following command line requests three copies of file INDIA.TXT: 

$ PRINT/COPIES=3 INDIA.TXT 

If you specify /COPIES after the PRINT command name, each file is printed 
the number of times you specify. For example, to print three copies each of 
BOMBAY.TXT and LAHORE.MEM, type: 

$ PRINT/COPIES=3 BOMBAY.TXT, LAHORE.MEM 

If you specify /COPIES after a file specification, PBS prints only that file the 
specified number of times. The following command line requests two copies 
of NEPAL.DAT, one copy of SIKKIM.DAT (by default), and five copies of 
BHUTAN.DAT: 

$ PRINT NEPAL.DAT/COPIES=2,SIKKIM.DAT,BHUTAN.DAT/COPIES=5 
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The /COPIES qualifier differs from /JOB_COUNT in the order in which multiple 
files are printed. For example, if you request three copies of files TEDFOR.BOB 
and MOODY.JON, PBS prints three copies of TEDFOR.BOB, followed by three 
copies of MOODY. JON. 

$ PRINT/COPIES=3 TEDFOR.BOB,MOODY.JON 

/[NO]DELETE 

Controls whether files are deleted after printing. /NODELETE is the default. 

If you specify /DELETE after the PRINT command name, all files specified are 
deleted after printing. For example: 

$ PRINT/DELETE OUTPUT.DAT,RESULT.TXT 

Both OUTPUT.DAT and RESULT.TXT are deleted after printing. 

If you specify /DELETE after a file-spec, only that file is deleted after printing. 
For example: 

$ PRINT CONCRD.MAS, LOWELL.MAS/DELETE, BOXBRO.MAS 

Only the file LOWELL.MAS is deleted after printing. 

You must have write access to the file to delete it after printing, 

/[NO]FEED 

Specifies whether the printer should leave six blank lines at the end of each page. 
The default is /FEED. 

/[NO]FLAG_PAGES 

Specifies whether flag (file header) pages should be printed at the beginning of 
each file listing. If you specify /FLAG_PAGES, the number of flag pages printed 
is determined by the system manager, and may vary according to the form you 
specify with the /FORMS qualifier. 

/[NO]TRUNCATE 

Indicates whether lines that exceed the width of the page should be truncated. 
The system manager determines the page width; it may vary according to the 
form you specify with the /FORMS qualifier. 

The default is /NOTRUNCATE, which means that lines exceeding the form width 
continue, or ’wrap," onto the next line. 

/[ NOJWRAP 

Indicates whether or not the characters that exceed the form width should print 
on the same line. The default is /WRAP. 
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9.3.10 SET ENTRY Command 


Format 


SET ENTRY entry-spec or entry-number 


Command Qualifiers 

/[NO] AFTE R=date :time 

/ALL 

/BATCH 

/CPU_LIMIT=n 

/CP U_LIMIT=UN LIMITED 

/FORMS=form-name 

/HOLD 

/JOB_COUNT=n 

/PAGE_LIMIT=n 

/PAGE_LIMIT=UNLIMITED 

/PRINT 

/PRIORITY=n 

/RELEASE 

/TIME_LIMIT=n 

/TIME_LIMIT=UNLIMITED 


Defaults 


See discussion 
See discussion 
See discussion 
See discussion 


See discussion 
See discussion 
See discussion 


See discussion 
See discussion 


Prompts 

Entry: entry-spec or entry-number 


Command Parameters 

entry-spec 

entry-number 

Specifies either the entry-spec or entry-number of the print or batch entry to be 
modified. If you specify the entry-spec, PBS modifies all entries matching the 
specification. If you specify the entry-number, PBS modifies only the entry with 
the matching number. Wildcards are allowed. 

Command Qualifiers 

/[NO]AFTER=date:time 

Specifies a date:time value after which the entry is eligible for printing or batch 
processing. 

If you specify only a time value, PBS assumes today’s date. If you specify only a 
date value, PBS assumes the end of the day (11:59 p.m.). 

For example, you type the following command line to have a job named BOCAT 
printed after March 2 at 1:00 in the afternoon: 

$ SET ENTRY BOCAT/AFTER=02-JUN-90:01:00PM 

The /NOAFTER qualifier releases an entry (previously set with the /AFTER 
qualifier) for immediate processing. 
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/ ALL 

Specifies that all of your entries are to be modified. Using the /ALL qualifier is 
the same as specifying the entry-spec *:[*,*]*, although you may include other 
qualifiers to restrict the entries selected. 

/BATCH 

Specifies that only batch queue entries be modified. 

By default, both print and batch queue entries are selected to be changed. 

/CPU_LIMIT=n 

/CPU_LIMIT=UNLIMITED 

(Batch entries only.) Specifies the maximum CPU time, in minutes, allowed for 
the batch job. This limit applies to the entire batch job, not to each command 
procedure within the job. 

If you specify /CPU_LIMIT=UNLIMITED, the batch request’s queue must 
also have its maximum CPU limit set to UNLIMITED. A batch request with 
CPU_LIMIT=UNLIMITED is allowed an infinite amount of CPU usage during 
processing. 

/FORMS=form-name 

(Print entries only.) Specifies the name of the form required by the entry. See 
your system manager to find out which form names you can specify. 

/HOLD 

Specifies that the entry be placed in a HOLD state on the print or batch queue. 
PBS does not process entries in a HOLD state until you release them with the 
SET ENTRY/RELEASE command. 

/JOB_COUNT=n 

(Print entries only.) Specifies that the entire job be printed n times, from 1 to 
255. 

/PAGE_LIMIT=n 

/PAGE_LIMIT=UNLIMITED 

(Print entries only.) Specifies the maximum number of pages to be printed in the 
job. You can specify only up to the maximum page limit assigned to the queue by 
the system manager, unless you have sufficient privilege to specify a higher limit. 

You can specify /PAGE_LIMIT=UNLIMITED only if the queue’s maximum page 
limit is also set to UNLIMITED. 

/PRINT 

Specifies that only print queue entries be modified. 

The default is that both print and batch queue entries are selected to be changed. 

/PRIORITY=n 

Specifies the priority of the print or batch request, in the range 1 to 255. PBS 
processes entries with higher priorities before those with lower priorities. You 
cannot specify a priority higher than the queue’s maximum. 

/RELEASE 

Specifies that an entry previously placed in a HOLD state be released. 
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/TIME_LIMIT=n 

/TIME_LIMIT=UNLIMITED 

(Batch entries only.) Specifies the maximum elapsed time, in minutes, allowed 
for the requested batch job. This limit applies to the entire batch job, not to each 
command procedure within the job. 

If you specify /TIME_LIMIT=UNLIMITED, the batch request’s queue must 
also have its maximum time limit set to UNLIMITED. A batch request with 
TIME_LIMIT=UNLIMITED is not limited to any amount of elapsed time during 
processing. 
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9.3.11 SET QUEUE Command 


This command modifies the characteristics of one or more queues. Changing a 
queue’s characteristics does not affect entries already on the queue. SET QUEUE 
requires PBSCTL privilege. 


Format 

SET QUEUE queue-name[:] 

Defaults 
See Discussion 
See Discussion 
Attributes are unchanged 
Attributes are unchanged 
Attributes are unchanged 
Attributes are unchanged 
Attributes are unchanged 
Attributes are unchanged 
See Discussion 
Attributes are unchanged 
Attributes are unchanged 
Attributes are unchanged 
Attributes are unchanged 
Attributes are unchanged 

Prompts 

Queue: queue-name[:] 


Command Qualifiers 
/ALL 
/BATCH 

/CPU_LIMIT=(MAXIMUM=a,DEFAULT=b) 

/CPU_LIMIT=n 

/[NOJDEFAULT 

/FO R MS=form-name 

/PAGE_LIMIT=(MAXIMUM=a,DEFAULT=b) 

/PAGE_LIMIT=n 

/PRINT 

/PRIORITY=(MAXIMUM=a,DEFAULT=b) 
/PRIORITY=n 
/PRIVILEGES=(priv[,...]) 
/TIME_LIMIT=(MAXIMUM=a,DEFAULT=b) 
/TIME LIMIT=n 


Command Parameters 

queue-name[:] 

Specifies the name of the queue to be modified. This command permits wildcard 
queue names. The rules for selecting queues when using wildcards are: 

• If you specify /PRINT or a print queue only qualifier, then PBS only selects 
print queues. 

• If you specify /BATCH or a batch queue only qualifier, then PBS only selects 
batch queues. 

• If neither of the above rules are true, then PBS selects any queue. 

Command Qualifiers 

/ALL 

Indicates that all queues should be modified. If you specify /ALL, PBS omits the 
queue name prompt and uses the queue name * If you specify a queue name, 
PBS ignores this qualifier. 
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/BATCH 

Indicates that only batch queues should be modified. When you use /ALL with 
this qualifier, PBS modifies all batch queues. 

/CPU JJMIT=(MAXIMUM=a,DEFAULTS) 

/CPU_LIMIT=n 

Batch queues only. Indicates the maximum and default CPU time limits (in 
minutes) for each command file processed in a batch job started from this queue. 
The maximum CPU limit is the largest value that you can specify when issuing a 
request for the queue. The default CPU limit is the value that PBS assigns to a 
request that had no limit specified. 

The keyword UNLIMITED indicates that PBS does not enforce a CPU limit. 

If you do not specify the MAXIMUM argument, then PBS does not change the 
maximum CPU limit. If you do not specify the DEFAULT argument, then PBS 
does not change the default CPU limit. If you use the /CPU_LIMIT=n form, then 
PBS uses the value you specify for both the maximum and default limits. If you 
specify a numeric argument, it must be in the range 1 to 65,535. The default 
CPU limit cannot exceed the maximum CPU limit. 

If you do not specify this qualifier, then PBS does not change the queue’s current 
default and maximum values. 

/[NOJDEFAULT 

Indicates whether the queue should serve as the default queue for its type. If 
you specify /DEFAULT, then PBS marks the queue as the default queue for its 
type, and any queue already defined as the default queue is no longer marked 
as being the default queue. If you specify /NODEFAULT, then the queue is no 
longer marked as being the default queue for its type. You then have no default 
queue for that type. PBS does not return an error if you specify /NODEFAULT 
for a queue that is not currently marked as the default queue. 

If you do not specify this qualifier, then any current default queue is not affected. 

/FORMS=form-name 

Print queues only. Indicates if a default form name is defined for the queue. If 
you specify /FORMS=form-name, then the name you specify becomes the default 
for the queue and replaces any previous default form. 

If you do not specify this qualifier, then the queue’s current default form name is 
not changed. 

/PAGE_LIMIT=(MAXIMUM=a,DEFAULTS) 

/PAGE_LIMIT=n 

Print queues only. Indicates the maximum and default page limit for each file 
printed as part of a print job started from this queue. The maximum page limit 
is the largest value that you can specify when issuing a request for this queue. 
The default page limit is the value that PBS assigns to a request for this queue 
that had no limit specified. 

The keyword UNLIMITED indicates that no page limit is enforced. If you do not 
specify the MAXIMUM argument, then PBS does not change the maximum page 
limit. If you do not specify the DEFAULT argument, then PBS does not change 
the default page limit. If you use the /PAGE_LIMIT=n form, then PBS uses 
the value you specify for both the maximum and default limits. If you specify a 
numeric argument, it must be in the range 1 to 4,294,967,295. The default page 
limit cannot exceed the maximum page limit. 

If you do not specify this qualifier, then the queue’s current default and maximum 
values are not changed. 
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/PRINT 

Indicates that only print queues should be modified. When you use /ALL with 
this qualifier, PBS modifies all print queues. 

/PRIORITY=(MAXIMUM=a,DEFAULTS) 

/PRIORITY=n 

Defines the maximum and default priorities for the queue, in the range 1 to 255. 
If you do not specify the MAXIMUM argument, then PBS does not change the 
current maximum priority. If you do not specify the DEFAULT argument, then 
PBS does not change the current default priority. If you use the /PRIORITY=n 
form, then PBS uses the value you specify for both the maximum and default 
priorities. The default priority cannot exceed the maximum priority. 

If you do not specify this qualifier, then the queue’s current default and maximum 
values are not changed. 

/PRIVILEGES=(priv[,...]) 

Specifies the set of privileges required for a user to place entries on the queue. 

A user who issues a PRINT or SUBMIT command must have all of the queue’s 
privileges for the request to be accepted. PBS accepts any of the RSTS/E 
keywords, plus the keywords ALL and NONE. 

The /PRIVILEGES=ALL qualifier assigns all defined privileges to the queue; 
/PRIVILEGES=NONE assigns no privileges to the queue. Note that you can 
specify any privilege name with /PRIVILEGES, even those that you do not 
possess. 

The argument can also be USERn, where n is an integer between 1 and 8. You 
can use these USERn privileges to identify particular users or groups of users 
and to restrict the queues usage to those users. 

If you specify this qualifier, PBS replaces the queue’s current privileges with 
those in the argument list. If you do not specify this qualifier, the queue’s current 
privileges are unchanged. 

/TIME_LIMIT=(MAXIMUM=a,DEFAULT=b) 

/TIME_LIMIT=n 

Batch queues only. Indicates the maximum and default elapsed time limits (in 
minutes) for each command file processed in a batch job started from this queue. 
The maximum time limit is the largest value that a user can specify when issuing 
a request for this queue. The default time limit is the value PBS assigns to a 
request that had no limit specified. 

The keyword UNLIMITED indicates that PBS does not enforce a time limit. 

If you do not specify the MAXIMUM argument, then PBS does not change the 
current maximum time limit. If you do not specify the DEFAULT argument, 
then PBS does not change the current default time limit. If you use the /TIME_ 
LIMIT=n form, then PBS uses the value you specify for both the maximum and 
default limits. If you specify a numeric argument, it must be in the range 1 to 
65,535. The default time limit cannot exceed the maximum time limit. 

If you do not specify this qualifier, then the queue’s current default and maximum 
values (if any) are not changed. 
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9.3.12 SET SERVER Command 


Format 


This command changes the characteristics of one or more servers. Use this 
command to change forms for print servers. SET SERVER requires PBSCTL 
privilege. 


SET SERVER server-name[.:] 

Command Qualifiers 
/ALL 
/BATCH 

/[NO]CONTROLS[=UP_ARROW] 

/FORMS=form-name 

/PRINT 

/PRIORITY[=n] 

/RUN_BURST[=n] 

/[NOJSHAREABLE 

Prompts 

Server: server-name[:] 


Defaults 

See Discussion 
See Discussion 
Attributes are unchanged 
Attributes are unchanged 
See Discussion 
/PRIORITY=-8 
/RU N_BU RST=6 
Attributes are unchanged 


Command Parameters 

server-name[:] 

Specifies the name of the server to be modified. This command permits wildcard 
server names. 

Command Qualifiers 

/ALL 

Indicates that all servers should be modified. If you specify /ALL, PBS omits the 
server name prompt. If you specify a server name, PBS ignores this qualifier. 

/BATCH 

Indicates that only batch servers should be modified. When you use /ALL with 
this qualifier, PBS modifies all batch servers. 

/[NO]CONTROLS[=UP_ARROW] 

Print servers only. Indicates how print servers should process control characters 
and escape sequences. If you do not specify this qualifier, then PBS does not 
change the current CONTROLS setting. You must have the PBSCTL privilege to 
use this qualifier. 
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/FORMS=form-name 

Print servers only. Indicates the name of the form installed on the printer. The 
server only prints requests with the same form name. PBS returns an error if the 
form name you specify for the device does not exist in the FDF. 

If you do not specify this qualifier, then the server’s current form is not changed. 

/PRINT 

Indicates that only print servers are to be modified. When you use /ALL with this 
qualifier, PBS modifies all print servers. 

/PRIORITY[=n] 

Batch servers only. Indicates the priority at which to run command procedures 
controlled by this server. This value cannot exceed the priority of the PBS 
primary job. PBS accepts any value in the range -120 to +120. PBS rounds the 
value down to a multiple of 8. 

If you do not specify an argument with /PRIORITY, the server’s priority is set 
to -8. If you do not specify this qualifier, then the batch server’s priority is not 
changed. You must have the TUNE privilege to use this qualifier. 

/RUN_BURST[=n] 

Batch servers only. Indicates the run burst to assign to any command procedures 
controlled by this server. PBS accepts any value in the range 1 to 127. 

If you do not specify an argument with /RUN_BURST, the server’s run burst is 
set to 6. If you do not specify this qualifier, then the batch server’s run burst is 
not changed. You must have the TUNE privilege to use this qualifier. 

/[NOJSHAREABLE 

Indicates if the device should be made shareable with other jobs on the system. 

If you specify /NOSHAREABLE, then PBS immediately allocates the device, 
preventing other jobs from accessing the device. The device is deallocated 
whenever you delete the server (with the DELETE/SERVER command) or 
shut down PBS (with the STOP/QUEUE/MANAGER command). If you specify 
/NOSHAREABLE and the device is not currently available, PBS displays a 
warning message and allocates the device as soon as it becomes available. 

/SHAREABLE indicates that the device can be shared by other jobs on the system 
and PBS only allocates it when the server is active. 

For batch servers, /SHAREABLE means the server uses a dynamic pseudo 
keyboard with terminal characteristics that cannot be set; /NOSHAREABLE 
means the server uses a static pseudo keyboard, with terminal characteristics 
that can be set. Digital recommends that you use /SHAREABLE unless you need 
specific terminal characteristics . 

If you do not specify this qualifier, then the [NOJSHAREABLE characteristic is 
not changed. 
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9.3.13 SHOW ENTRY Command 


Format 

SHOW ENTRY [entry-spec or entry-number] 

Command Qualifiers 

Defaults 

/ALL 

/BATCH 

See discussion 

/BRIEF 

/BRIEF 

/FILES 

/BRIEF 

/FULL 

/BRIEF 

/[N 0]OUTPUT[=f i lespec] 

Your terminal 

/PRINT 

See discussion 

/STATUS[=(keyword[,...]) 

All entries 


Command Parameters 

entry-spec 

entry-number 

Specifies the entry-spec or entry-number of the entry you want to display Use the 
entry-number when you want to display a single entry. Use the full entry-spec 
(queue:[ppn]name) to display all entries meeting the specification. 

You can specify wildcard characters anywhere in the entry-spec. If you do not 
specify any entry parameter, the SHOW ENTRY command displays all print and 
batch entries owned by you. 

NOTE 

By default, PBS does not display entries by queue. To see a list of the 
entries in a particular queue, specify the queue-name in the entry-spec. 

Command Qualifiers 

/ALL 

Specifies that all entries are to be displayed. Using the /ALL qualifier is the same 
as specifying the entry-spec *:[*,*]*, although you may include other qualifiers to 
restrict the entries selected. 

If you do not specify /ALL, the entry-spec defaults to entries with your PPN. 

/BATCH 

Specifies that only batch queue entries be displayed. This qualifier conflicts with 
/PRINT. 

The default is that both print and batch queue entries are displayed. 
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/BRIEF 

Requests a brief listing of information about entries in the queue. It is the 
default. For example: 

$ SHOW ENTRY/BRIEF 

Entry Pos Type Queue Owner Name Status Pri 

3686 1st Batch BASELEVEL [ 1,170] BLDMGR STARTED 255 

The /BRIEF qualifier displays the following information about each entry: 

• Entry number 

• Position — the entry’s start position relative to other entries 

• Entry type - Print or Batch 

• Queue name 

• Owner’s PPN 

• Entry name 

• Entry status - one of the following: 

— READY - The entry is ready for processing. 

- AFTER - The entry is waiting for an /AFTER date and time to be met 
before it can start processing. 

— FORMS_WAIT — The print or batch entry cannot be started because its 
associated form is not currently installed on any print server assigned to 
the entry queue. 

- HOLD - The entry is waiting for a SET ENTRY/RELEASE command in 
order to start processing. 

— STARTED - The entry has started processing. (Use the /FULL qualifier 
to display the date and time that the entry started.) 

— ABORTING — The entry is in the process of being terminated. 

• Priority in the queue 

/FILES 

Displays all file-specs, and their qualifiers, included in the entry. Unless you have 
additional privilege, you can only see the file-specs contained in your own entries. 

/FULL 

Displays the full status of each entry. In addition to all the information shown by 
the /BRIEF and /FILES qualifiers, the /FULL qualifier also displays the following: 

• Priority 

• JOB_COUNT (number of copies to be printed) 

• Date and time the entry was submitted 

• Date and time the entry was last modified (if ever) 

• Date and time the entry started processing 

• AFTER date and time (specified by the /AFTER qualifier) 

• Server name (if the job is STARTED) 
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For example: 

$ SHOW ENTRY/FULL 

Entry Pos Type Queue Owner Name Status Pri 

3686 1st Batch BASELEVEL [ 1,170] BLDMGR STARTED 255 

Entered 19-Feb-90 08:23 AM 

Started 19-Feb-90 11:25 AM on batch server _BA9: 

CPU limit UNLIMITED, Time limit UNLIMITED 
Log file _SY: [1,170]BLDMGR.LOG, No log queue 
No parameters 

1> _DU13:[170,59]BLDMGR.COM 

/[NO]OUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 

/PRINT 

Displays only entries on print queues. 

/STATUS[=(keyword[,...])] 

Displays all of the entries in PRINT or BATCH queues having the specified 
keyword or keywords and that are currently being processed or waiting to be 
processed. The keywords are: 

• AFTER displays entries having the status AFTER, indicating they are 
waiting for the specified after date-time to elapse. 

• ABORTING displays entries having the status ABORTING, indicating they 
have started but are in the process of being terminated. 

• FORMS_WAIT displays print entries having the status FORMS_WAIT, 
indicating they are waiting for the required form to be installed on the 
assigned print server. 

• HOLD displays entries having the status HOLD, indicating they cannot 
start until they are taken off HOLD status using the SET ENTRY/RELEASE 
command. 

• READY displays entries having the status READY, indicating they are 
waiting for a print or batch server to become available. 

• STARTED displays entries having the status STARTED, indicating they are 
currently being processed. 

For compatibility with VMS, RSTS/E supports the VMS SHOW ENTRY qualifier 
/BY_JOB_STATUS and most of its keyword arguments. The RSTS/E keywords 
and their VMS synonyms are: 


RSTS/E Syntax 

VMS Synonym 

$ SHOW ENTRY/STATUS 

$ SHOW ENTRY/BY_JOB_STATUS 

=ABORTING 

none 

=AFTER 

=TIMED_RELEASE 

=FORMS_WAIT 

none 

=HOLD 

=HOLDING 

=READY 

=PENDING 

=STARTED 

EXECUTING 
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9.3.14 SHOW QUEUE Command 


Format 


SHOW QUEUE queue-name[:] 


Command Qualifiers 

/ALL 

/BATCH 

/BRIEF 

/FULL 

/PRINT 

/[NO]OUTPUT[=filespec] 


Defaults 

See discussion 

/BRIEF 

/BRIEF 

See discussion 
your terminal 


Prompts 

Queue: queue-name[:] 


Command Parameters 

queue-name 

Specifies the name of the queue to be displayed. Wildcards are allowed. 

Command Qualifiers 

/ALL 

Specifies that all queues be displayed. 

/BATCH 

Specifies that only batch queues be displayed. 

The default is to display all queues matching the queue-name parameter, 
regardless of type. 

/BRIEF 

Specifies a brief display (the default), which includes the following information 
about the specified queue: 

• Queue type—Print or Batch 

• Queue name 

• Queue status—one or more of the following: 

— DEFAULT—Queue is the default queue. 

— OPEN—Queue can accept requests. 

— CLOSED—Queue will not accept requests. 

— STARTED—Entries on the queue can be started. 

— STOPPED—Entries on the queue cannot be started. 

— MARKED FOR DELETION—Queue will be deleted as soon as it becomes 
empty. 
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/FULL 

Specifies a full display, which includes all the information in the brief (default) 
display, along with the following additional information: 

• Default form name (Print queues only)—The name assigned to the default 
paper form in the printer. 

• Default/maximum priority—The default priority assigned to entries in the 
queue and the maximum priority that can be specified for entries. 

• Default/maximum page limit (Print queues only)—The default page limit 
assigned to entries in the queue and the maximum page limit that can be 
specified for entries. 

• Default/maximum CPU limit (Batch queues only)—The default CPU limit 
assigned to entries in the queue and the maximum CPU limit that can be 
specified for entries. 

• Default/maximum time limit (Batch queues only)—The default time limit 
assigned to entries in the queue and the maximum time limit that can be 
specified for entries. 

• Assigned servers—The list of print and batch servers currently assigned to 
the queue. 

/[NO]OUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 

/PRINT 

Specifies that only print queues be displayed. 

The default is to display all queues matching the queue-name parameter, 
regardless of type. 
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9.3.15 SHOW SERVER Command 


This command displays the status of one or more servers in PBS. The display 
includes information about the server’s characteristics, its current status, and the 
queues assigned to the server. SHOW SERVER requires no privileges. 


Format 


SHOW SERVER 

Command Qualifiers 
/ALL 
/BATCH 
/BRIEF 
/FULL 
/[NO]OUTPUT[=filespec] 
/PRINT 


[server-name[:j'] 

Defaults 
/ALL 
none 
/BRIEF 
/BRIEF 
your terminal 
none 


Prompts 

none 


Command Parameters 

server-name[:] 

Specifies the name of the server to be displayed. If you do not specify a server 
name, all servers are displayed. This command does not permit wildcard server 
names. 

Command Qualifiers 

/ALL 

Specifies that all servers are to be displayed. /ALL is the default if no server 
name is specified. If a server name is specified, this qualifier is ignored. 

/BATCH 

Specifies that only batch servers are to be displayed. 

/BRIEF 

Specifies a brief display. It is the default. The brief display includes the following 
information: 

• On line or Off line — Print servers only. Indicates the current status of the 
server’s print device. Note that PBS does not detect an off-line device until 
it attempts to print on it; all devices are assumed to be on line when PBS 
first starts. KB-type printers are considered off-line when an XOFF (Ctrl/S) 
characters causes the device to stall for an extended period of time. 

• Active — Indicates that the server is currently processing a request. 

Idle Indicates that the server is not currently processing a request. 
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• Stopped — Indicates that the server is currently stopped and will not accept 
any new requests. The server may or may not be active. 

• Job-wait — Indicates that PBS is unable to create a secondary job because no 
job slots are currently available. PBS will keep trying to create the second job 
until it succeeds. 

• Device-wait — Indicates that PBS is unable to allocate a device because the 
device is not available. For print servers, device-wait means that the printer 
controlled by the server is allocated to or opened by another job. For batch 
servers, device-wait means that no pseudokeyboards are currently available. 
PBS will keep trying to allocate the device until it succeeds. 

• Shareable or Nonshareable — For print servers, shareable means that the 
print device is available to other jobs on the system when it is not in use 
by the server. Nonshareable means that the print device is permanently 
allocated to the server. 

For batch servers, shareable means the server uses a dynamic pseudo 
keyboard, with nonspecifiable characteristics. Nonshareable means that 
the server uses a static pseudo keyboard that therefore does not change 
characteristics; rather, it uses the characteristics specified. 

• Form name — Print servers only. Indicates the name of the forms currently 
installed, or M No forms" if no forms are installed. 

/FULL 

Specifies a full display. The full display includes all of the information in the brief 

display, and also includes the following information: 

• Current entry — If the server is active, PBS displays the entry number and 
entry spec of the current entry. 

• Assigned queues — PBS displays a list of the queues which can route requests 
to the server. 

/[NO]OUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 

information is suppressed and not displayed. If the optional filespec argument is 

omitted, the output displays on the terminal. 

/PRINT 

Specifies that only printer servers are to be displayed. 
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9.3.16 START/QUEUE Command 


This command starts a queue that was stopped with the STOP/QUEUE 
command. Once you start a queue, PBS processes waiting entries on the 
queue. If you already started the specified queue, PBS ignores this command. 
START/QUEUE requires PBSCTL privilege. 


Format 

START/QUEUE queue-name[:] 

Command Qualifiers 
none 

Prompts 

Queue: queue-name[:] 


Command Parameters 

queue-name[:] 

Specifies the name of the queue to be started. This command does not permit 
wildcard queue names. 
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9.3.17 START/QUEUE/MANAGER Command 


This command starts PBS following this procedure: 

1. Creates the PBS primary job as a detached job running in the user’s account. 
RSTS/E initializes the job’s priority and run burst according to the package 
configuration parameters. 

2. Compresses the PBS system file by removing any records that are marked 
as deleted. (This step reduces the overall size of the file.) During this step, 
if RSTS/E finds an entry with status STARTED, it retains the entry, placing 
it on HOLD. This can happen if RSTS/E restarts the package after a system 
crash. 

3. Loads all queue definitions into memory from the PBS system file. 

4. Loads all server definitions into memory from the PBS system file. If a print 
server device is not a valid device on the system, PBS marks the server 
DISABLED. 

5. Assigns servers to queues based on the assignment information maintained in 
the PBS system file. 

6. Attempts to permanently allocate a device for any server marked as 
NOSHAREABLE in its server’s definition. If the allocation fails because 
the device is currently in use, PBS marks the server DEVICE-WAIT and 
attempts to allocate the device periodically until the allocation succeeds. 

7. Confirms startup has successfully completed by displaying a message. 

The startup procedure can take from a few seconds to several minutes, depend¬ 
ing on the number of pending requests in the queue. Most users include the 

START/QUEUE/MANAGER command in their system startup command file 

so the time required for PBS startup is added to normal system startup time. 

START/QUEUE/MANAGER requires PBSCTL privilege. 


Format 


START/QUEUE/MANAGER 


Command Qualifiers 

/PRIORITY=n 

/RUN_BURST=n 


Defaults 
/PRIORITY—8 
/RUN BURST=6 


Prompts 


none 
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Command Qualifiers 

/PRIORITY=n 

Specifies the priority of the detached PBS job and any secondary jobs that PBS 
creates. Value must be in the range -120 to +120; with any value specified 
rounded down to a multiple of 8. The default is -8. 

/RUN_BURST=n 

Specifies the run burst of the detached PBS job and any secondary jobs that PBS 
creates. Value must be in the range 1 to 127. The default is 6. 
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9.3.18 START/SERVER Command 


This command restarts a server that was stopped with the STOP/SERVER 
command. If the server has a stalled job when you issue the command, the 
command either resumes the job or terminates it, depending on the qualifiers you 
use. 

For print servers, the job can be resumed at a specified page of the current 
file copy. PBS ignores this command if the specified server is already started. 

For batch servers, PBS releases the controlled batch job from its held state. 
START/SERVER requires PBSCTL privilege. 


Format 


START/SERVER server-name[:] 

Command Qualifiers 

Defaults 

/BACKSPACE[=n] 

See Discussion 

/FORWARDSPACE[=n] 

See Discussion 

/NEXTJOB 

See Discussion 

/PAGE=n 

See Discussion 

/RESTART 

See Discussion 

/TOP_OF_FILE 

See Discussion 

Prompts 


Server: server-name[:] 



Command Parameters 

server-name[:] 

Specifies the name of the server to be started. This command does not permit 
wildcard server names. 

Command Qualifiers 

/BACKSPACE[=n] 

Print servers only. Indicates that printing should resume n pages back in the 
current file listing. If you do not include an argument, then printing resumes one 
page before the current page. If you specify an argument that extends beyond the 
beginning of the file, then printing resumes at the beginning of the current file 
copy. 

PBS ignores this qualifier if the specified server is idle. 

/FORWARDSPACE[=n] 

Print servers only. Indicates that printing should resume n pages forward in the 
current file listing. If you do not include an argument, printing resumes one page 
after the current page. If you specify an argument that extends beyond the end 
of the current file, printing resumes at the next file copy, if any. 

PBS ignores this qualifier if the specified server is idle. 
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/NEXTJOB 

Indicates that the current job should be aborted and printing or batch processing 
should resume at the next job, if any. 

PBS ignores this qualifier if the specified server is idle. 

/PAGE=n 

Print servers only. Indicates that printing should resume at page n in the current 
file listing. If you specify an argument that extends beyond the end of the file, 
printing resumes at the next file copy, if any. A value of 1 indicates the first page 
of the file; PBS does not include header pages in the count. 

PBS ignores this qualifier if the specified server is idle. 

/RESTART 

Print servers only. Indicates that printing should resume at the beginning of the 
current job copy. If you submit the job with a /JOB_COUNT qualifier argument 
larger than one, PBS only restarts the current job copy. 

PBS ignores this qualifier if the specified server is idle. 

/top_of_file 

Print servers only. Indicates that printing should resume at the beginning of the 
current file copy. If the file being printed was submitted with a /COPIES qualifier 
argument larger than one, PBS only restarts the current file copy. 

PBS ignores this qualifier if the specified server is idle. 
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9.3.19 STOP/QUEUE Command 


This command stops a queue; that is, PBS prevents any pending requests on the 
queue from being processed. Any requests that are currently being processed are 
not affected. STOP/QUEUE requires PBSCTL privilege. 

PBS ignores this command if the specified queue is already stopped. 


Format 

STOP/QUEUE queue-name[:] 

Command Qualifiers 
none 

Prompts 

Queue: queue-name[:] 


Command Parameters 

queue-name[:] 

Specifies the name of the queue to be stopped. This command does not permit 
wildcard queue names. 
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9.3.20 STOP/QUEUE/MANAGER Command 


This command lets you shut down PBS, either immediately (causing all 
currently active jobs to be terminated) or when all servers become idle. 
STOP/QUEUE/MANAGER requires PBSCTL privilege. 

You can shut down PBS in two ways: 

• As part of normal system shutdown. The SHUTUP program includes a phase 
for automatically shutting down PBS, either immediately or when all print or 
batch jobs currently in progress complete. 

• Manually, using the STOP/QUEUE/MANAGER command. 


Format 

STOP/QUEUE/MANAGER 

Command Qualifiers Defaults 

/[NO] ABORT /NOABORT 

Prompts 

none 


Command Qualifiers 

/[NOJABORT 

Indicates whether any print or batch jobs currently running should be aborted 
before shutting down PBS. Use /ABORT to shut down PBS immediately; use 
/NOABORT to let all currently running print or batch jobs complete. The default 
is /NOABORT. 
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9.3.21 


STOP/SERVER Command 


This command stops a print or batch server. The action taken depends on 
whether the server is currently active or not. For queues that are assigned to 
only one server, stopping the server is equivalent to stopping the queue. For 
queues that are assigned to more than one server, stopping one server does 
not prevent requests from being routed to other active servers. STOP/SERVER 
requires PBSCTL privilege. 

If you issue a STOP/SERVER command for a server that is not currently pro¬ 
cessing a request, no additional requests are routed to that server. However, if 
you issue a STOP/SERVER command for a server that is currently processing a 
request, the following action is taken depending on the server: 

• Batch servers — If you specify the /JOB_END qualifier, PBS lets the current 
batch job complete before stopping the server. Otherwise, the server suspends 
the batch job by assigning it a priority of -128. The server then waits until 
PBS issues a START/SERVER command to either resume or terminate the 
batch job. 

• Print servers — If you specify the /PAGE_END, /FILE_JEND or /JOBJSND 
qualifier, PBS does not stop the server until it completes the current page, 
file copy, or job copy. If the copy is the final copy of the job, PBS lets the job 
finish before it stops the server. If you do not specify any of the qualifiers, 
PBS stops the server immediately. 

When PBS directs the server to stop, the server stops sending data to the 
printer. However, system buffers continue to be printed on the device until 
they become empty. This is necessary to prevent PBS from losing proper 
page positioning on the printer. The server then waits until you issue a 
START/SERVER command to either resume or terminate the print job. 


Format 


STOP/SERVER server-name[.:] 


Defaults 

See Discussion 
See Discussion 
See Discussion 

Prompts 

Server: server-name[:] 


Command Qualifiers 
/FILE_END 
/JOBEND 
/PAGE END 


Command Parameters 

server-name[:] 

Identifies the server to be stopped. This command does not permit wildcard 
server names. 
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Command Qualifiers 

/FILE_END 

Print servers only. Indicates that printing should stop after the current file copy 
is finished printing. 

Note that this qualifier conflicts with /JOB_END and /PAGE_END. 

/JOB_END 

For print servers, indicates that printing should stop after the device has finished 
printing the current job. For batch servers, indicates that the server should stop 
when the current batch job completes. 

Note that this qualifier conflicts with /FILE_END and /PAGEJEND. 

/PAGE_END 

Print servers only. Indicates that printing should stop at the end of the current 
page. 

Note that this qualifier conflicts with /FILE_END and /JOB_END. 
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9.3.22 SUBMIT Command 

Format 


SUBMIT file-specf,...] [entry-spec] 

Command Qualifiers 

Defaults 

/AFTER=date:time 


/CPU_LIMIT=n 

See discussion 

/CPU_LIMIT=UNLIMITED 

See discussion 

/HOLD 


/[N 0] LOG_D E LETE 

/NOLOG JDELETE 

/[NO]LOG_FILE=file-spec 

See discussion 

/[NO]LOG_QUEUE=queue-name 

/NOLOG_QUEUE 

/NAME=entry-name 

See discussion 

/[NOJNOTIFY 

/NONOTIFY 

/OWNER=ppn 

See discussion 

/PAR AM ETERS=(parameter,...) 


/PRIORITY=n 

See discussion 

/QUEUE=queue-name 

See discussion 

/TIME_LIMIT=n 

See discussion 

/TIME_LIMIT=UNLIMITED 

See discussion 

File Qualifiers 

Defaults 

/[NO]DELETE 

/NODELETE 

Prompts 


File: file-spec[,...] 



Command Parameters 

file-spec 

Specifies one or more command files (procedures) to be submitted for batch job 
execution. You must specify a file name. If you do not specify a file type, PBS 
assumes a default file type of .COM, and if you do not specify a device, PBS 
assumes the default device _SY:. Wildcards are allowed. 

You can only submit files to which you have read access. For each file-spec in 
the SUBMIT command, PBS attempts to find at least one file to which you have 
read access; if it finds none, PBS displays an error message and refuses the batch 
request. If you specify the /DELETE qualifier with a file-spec, you must have 
both read and write access. 

entry-spec 

The entry-spec specifies the queue and the name of the entry in the format queue- 
name :[PPN]entry-name. The entry-name can contain from one to nine characters. 
If you do not specify a queue, PBS submits the entry on the default batch queue. 
If you do not specify an entry-name, PBS assigns the first nonnumeric file name 
in the list of file-specs, or BATCH if none is found. Your own PPN is the default. 
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Command Qualifiers 

/AFTER=date:time 

Specifies a date:time value after which the entry is eligible for batch processing. 
If you do not specify this qualifier, PBS assumes the entry is immediately eligible. 

If you specify only a time value, PBS assumes today’s date. If you specify only a 
date value, PBS assumes the end of the day (11:59 p.m.). 

/CPU_LIMIT=n 

/CPU_LIMIT=UNLIMITED 

Specifies the maximum CPU time, in minutes, allowed for your batch job. This 
limit applies to the entire batch job, not to each command procedure within the 
job. You can only specify the maximum CPU limit of the batch request’s queue. 

If you specify /CPU_LIMIT=UNLIMITED, the batch request’s queue must 
also have its maximum CPU limit set to UNLIMITED. A batch request with 
CPU_LIMIT=UNLIMITED is allowed an infinite amount of CPU usage during 
processing. 

If you do not specify this qualifier, PBS assigns the batch queue’s default CPU 
limit. 

/HOLD 

Specifies that the entry be placed in a HOLD state on the queue. Entries 
in a HOLD state are not processed until you release them with the SET 
ENTRY/RELEASE command. 

/[NO]LOG_DELETE 

Specifies whether the log file should be deleted after printing. The default is 
/NOLOG_DELETE. 

/[NO]LOG_FILE [=file-spec] 

Specifies whether a log file is created for the batch job and if so, the file-spec of 
the log. By default, PBS creates a log file at the start of a batch job. 

If you do not specify a file-spec, PBS creates the log file in your own account on 
the default device SY:, using the first six characters of the entry name and a file 
type of .LOG. (Any file with the same name will be replaced.) 

If you specify a file-spec, PBS creates that file at the start of the batch job, 
replacing any file having the same name. 

/[NO]LOG_QUEUE [=queue-name] 

Specifies whether a log file should be queued for printing when the batch job 
completes and if so, the queue on which it should be printed. The default is 
/NOLOG_QUEUE. 

If you do not specify a queue name, PBS queues the log file on the default print 
queue. 

/NAME=entry-name 

Specifies the one- to nine-character name assigned to the entry. 
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/[NO]NOTIFY 

Specifies whether your terminal session is notified of changes to the status of the 
batch entry. Messages are sent when the: 

• Entry is started 

• Entry is completed 

• Entry is deleted from its queue 

• Print server processing a print entry goes off line 

The default is /NONOTIFY. 

/OWNER=ppn 

Indicates the owner of the batch job. You can only specify your own PPN, unless 
you have sufficient privilege to specify others. 

/PARAMETERS=(parameter[,...]) 

Specifies from one to eight optional parameters to be passed to the batch job. 

PBS assigns the parameters to the local symbols PI through P8 when it executes 
the first command procedure in the job. 

/PRIORITY=n 

Specifies the priority of the batch request, in the range 1 to 255. PBS processes 
entries with higher priorities before those with lower priorities. You cannot 
specify a priority higher than the queue’s maximum. 

/QUEUE=queue-name[:] 

Specifies the name of the queue on which the entry is placed. The queue specified 
must be a batch queue. 

Use the SHOW ENTRY command to verify an entry’s position in the queue. 

/TIMEJJMIT=n 

/TIMEJJMIT=UNLIMITED 

Specifies the maximum elapsed time, in minutes, allowed for the requested batch 
job. This limit applies to the entire batch job, not to each command procedure 
within the job. You can only specify the maximum time limit of the batch 
request’s queue. 

If you specify /TIME_LIMIT=UNLIMITED, the batch request’s queue must 
also have its maximum time limit set to UNLIMITED. A batch request with 
TIME_LIMIT=UNLIMITED is not limited to any amount of elapsed time during 
processing. 

If you do not specify this qualifier, PBS assigns the batch queue’s default time 
limit. 

File Qualifiers 

/[NO]DELETE 

Specifies whether the command file should be deleted after batch processing 
completes. You must have write access to the file for which you specify /DELETE. 
The default is /NODELETE. 

You may type the /DELETE qualifier after any file name to delete only that file, 
or you may type the /DELETE qualifier immediately after the SUBMIT command 
to delete all files included in the command. 
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Chapter 10 

Managing System Errors 


The RSTS/E monitor automatically logs both hardware and system level software 
errors. To gain the full advantages of this error detection capability, you must use 
the programs in the System Error Package. These programs fall into three main 
categories: 

• Extraction and retention of system errors 

• Extraction and retention of system errors not yet retrieved at the time of a 
system crash 

• Compilation and formatting of saved system errors 

When the monitor detects an error, routines save critical error-related data and 
send a message to the ERRCPY program. The system invokes ERRCPY, which 
then retrieves the saved data, performs minimal error message processing, and 
stores the error information in a specially formatted disk file (ERRLOG.FIL). 
Because RSTS/E limits the number of messages that may be queued to ERRCPY, 
it should be run at a higher priority than most jobs to prevent the loss of valuable 
diagnostic information. A separate program, ERRINT, initializes and validates 
the error logging file to minimize the size of ERRCPY. Normally, you run ERRINT 
at the beginning of system startup to start ERRCPY. 

When a system crash occurs and the system crash dump facility is enabled, 
the monitor preserves the contents of certain critical parts of the system in the 
system file [0,1] CRASH.SYS. Run the ANALYS program immediately following 
the recovery from a system crash to extract and format key information from the 
crash file. Normally, this is done by the system startup command file. One of the 
functions ANALYS performs is the creation of a separate error logging file (by 
default, ERRCRS.FIL) containing errors that were not processed by ERRCPY at 
the time of the crash and an ERRDIS report for the errors. 

NOTE 

You must have SWCTL privilege to run any component of the System 
Error Package. 


10.1 Use of the Error Logging Programs: ERRINT and ERRCPY 

The system program ERRCPY reads error-related information stored in the 
monitor part of memory and writes it to a special disk file called ERRLOG.FIL. 
The error file initialization and validation program (ERRINT) starts the ERRCPY 
program. ERRINT performs various file checking or generation functions and 
chains to ERRCPY. You must make sure the commands are in the START.COM 
file to start ERRINT (thus, ERRCPY) and that ERRCPY is active during 
timesharing operations. 
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10.1.1 Error Logging Initialization: ERRINT 

When the RSTS/E system starts up, DCL executes commands in the START.COM 
command file. The following command starts ERRINT: 

$ RUN ERROR$:$ERRINT 

When the system executes the previous command, the ERRINT program tries to 
locate the error file ERRLOG.FIL, which resides in ERROR$:. If it finds the file, 
ERRINT checks certain critical control information in the file. If this information 
is invalid, ERRINT renames the file ERRLOG.TMP, generates and initializes a 
new ERRLOG.FIL, and issues an informational message: 

Error File was found to be Invalid 

Error File was generated and Invalid File renamed ERRLOG.TMP 

If ERRINT does not find ERRLOG.FIL, it generates and initializes the file. 

Two other commands, corresponding to responses to ERRINT questions, must 
also be present in the command file. The two ERRINT dialogue questions for 
which you must include responses are: 

Change size to < 100 >? 

Utilize crash file output (YES/NO) <NO>? 

Once ERRINT validates or creates ERRLOG.FIL, it prints a message telling you 
what percentage of the file has been used. For example: 

ERRLOG file is 8% full 

ERRINT also prints a question that includes (in angle brackets) the maximum 
number of blocks allowed for the file: 

Change size to < 100 >? 

You can accept the current size of the file (originally 100 blocks) or change the 
maximum size if you want. You can also specify an optional switch, /LOCK. If 
you include /LOCK in your response, ERRCFY runs nonswappable. The default 
is that ERRCPY can be swapped out. 


NOTE 

When an error occurs, RSTS/E writes it to a disk file. If ERRINT has 
been swapped out to this same disk, RSTS/E does not log the error. If 
you lock ERRINT in memory, RSTS/E does not lose these errors. This 
is the only advantage of locking ERRINT in memory. 

However, if you lock ERRINT in memory, the system may hang, 
particularly if the memory is fragmented. The probability of the system 
hanging for this reason is a function of free memory available at any 
given time. Because the free memory is, in part, a function of total 
available memory, the probability of your system hanging for this 
reason goes down with increased total memory. 

The program then asks if you want to append the contents of the special error 
crash file ERRCRS.FIL to the contents of ERRLOG.FIL in the question: 

Utilize crash file output (YES/NO) <NO>? 

If you answer YES, ERRINT tries to find the file and add its contents to the 
end of the main error logging file. If it cannot find the error crash file, ERRINT 
ignores the command and continues. 
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After it finishes processing all of its functions, ERRINT detaches and chains to 
ERRCPY. At this point, the terminal on which ERRINT started is free for other 
use. 

The ERRINT program must be located in the error library account ERROR$. To 
rim ERRINT from this account, type RUN ERROR$:ERRINT and press Return. 

You can run ERRINT only if ERRCPY is not currently running. If you start up 
ERRINT while ERRCPY is running, then ERRINT exits after displaying the 
following message: 

?Error logger is already running 

Note that the version of ERRCPY that was running in a detached state on the 
system continues to run. 


10.1.2 Examples of ERRINT Dialogue 

An example of the ERRINT dialogue follows: 

$ run error$:errint<RET> 

ERRINT V10.0 RSTS V10.0 EDERE 

ERRLOG file is 8% full 

Change size to < 100 >? 120<RET> 

Utilize crash file output (YES/NO) <NO>? NO<RET> 

Detaching 

In this example, a valid error log file exists, has a maximum length of 100 blocks, 
and is 8 % full. If you change the maximum size to 120 blocks but decide not to 
add the special ANALYS error log file to the ERRINT error log file, the program 
detaches and chains to ERRCPY. 

In the next example, ERRINT finds an invalid error log file, renames the invalid 
file to ERRLOG.TMP, creates a new file, leaves the maximum size at 100 
blocks, and attaches the special error log file ERRCRS.FIL to the error log file 
ERRLOG.FIL. Note that the 2% full message indicates a file containing only 
control information; this is the state of a newly generated error log file: 

$ run error$:errint<RET> 

ERRINT V10.0 RSTS V10.0 EDERE 
Error file was found to be invalid 

New file was generated and invalid file renamed ERRLOG.TMP 
ERRLOG file is 2% full 
Change size to < 100 >?<RET> 

Utilize crash file output (YES/NO) <NO>? YES<RET> 

Detaching 


10.1.3 Error Logging: ERRCPY 

You can start the ERRCPY program only by running ERRINT. ERRCPY runs 
detached, processes incoming error messages, and writes each message as a 
variable-length record to a nonspanned sequential file (ERRLOG.FIL). When its 
message queue is empty, ERRCPY enters the receiver sleep state and may be 
swapped out. 

The monitor queues messages to ERRCPY regardless of the presence or absence 
of ERRCPY. (If ERRCPY is not running, the messages are simply left waiting, 
up to a limit of 40.) The first message the monitor queues on startup is always 
a "power fail/start up" message. On receiving a special error message from the 
SHUTUP program, ERRCPY logs the message, closes the error file, and kills 
itself. 
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10.2 Displaying Errors: ERRDIS 


The error display program ERRDIS provides you with a convenient method of 
displaying previously logged errors. 

ERRDIS has four functions: 

• Provides a summary report by error type and unit number (where applicable) 
of all errors logged to the error file 

• Provides a detailed report of one or all error types logged between any two 
user-selected date and time pairs 

• Zeroes some or all of the contents of the error file following the generation of 
a report 

• Provides a list of potentially bad disk blocks 

ERRDIS consists of two modules: ERRDIS and ERRDET. The first mod¬ 
ule performs the first and third functions. To perform the other functions, 
ERRDIS chains to ERRDET; control returns to ERRDIS when ERRDET finishes 
processing. 


10.2.1 Running ERRDIS 

You can run the ERRDIS program by typing: 

$ RUN ERROR$:ERRDIS 

After ERRDIS prints header information, you select optional modes of operation 
by means of an interactive dialogue. In the dialogue description shown in 
Table 10-1, prompts are numbered for reference. An answer enclosed in angle 
brackets (<>) indicates the default response; select the default by pressing Return 
in response to a program prompt. You can abbreviate most responses with two 
characters. Optional characters are enclosed in square brackets [ ]; for example 
HE[LP]. 

Table 10-1: ERRDIS Dialogue Explanation 

Step Prompt and Description 

1 ERRDIS V10.0 RSTS V10.0 EDERE 
ERRDIS prints an identification line. 

2 Input File <ERROR$:ERRLOG.FIL>? 

Enter a file specification for ERRDIS to process. The file must be formatted as 
an error logging file. 

3 Output to <KB:ERRDIS.OUT>? 

Enter a file specification to which ERRDIS should send the report. 


(continued on next page) 
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Table 10-1 (Cont.): ERRDIS Dialogue Explanation 


Step Prompt and Description 

4 He[lp], Ba[d Blocks], Su[mmary], Fu[ll] Report, or Ze[ro] File? <Summary>? 
Select one of five possible reports: 

• He[lp]. Prints a help file, followed by a list of mnemonics corresponding to 
all possible error types. 

• Ba[d Blocks]. Outputs a report of possible bad blocks detected from the disk 
errors logged in the input file entered in Step 2. The next dialogue step is 
11 . 

• Su[mmary]. Outputs a report of the number of errors detected for each error 
type and for each unit number within a specific error type. The next dialogue 
step is 10. 

• Fu[ll]. Outputs a report of the detailed contents of each selected error record 
in the error file. Selection of a specific record depends on the answers to 
steps 5 through 9 in the ERRDIS dialogue. 

• Ze[ro]. Zeroes the error file, either completely or by error type. The next 
dialogue step is 12. 

5 Specific Error Type <A11>? 

Enter a two-character mnemonic identifying the specific error type that you want 
ERRDIS to process. The default answer selects all error types. Note that if you 
select All, you may also attach the /NOTAPE switch if you want magnetic tape 
errors to be omitted from the error listing. 

6 Starting Date <First Error>? 

Enter the date of the earliest error that you want ERRDIS to process. The format 
is dd-mmm-yy or yy.mm.dd. The default answer is the date of the first error in 
the error log file. If you press Return to select the default, the next step is 8. 

7 Starting Time <First Error>? 

Enter the time of the earliest error that you want ERRDIS to process. The 
format is hh:mm, either in 24-hour time or with AM/PM afterwards. The default 
is the time of the first error in the error log file on the selected date. 

8 Ending Date <Last Error>? 

Enter the date of the latest error that you want ERRDIS to process. The format 
is dd-mmm-yy or yy.mm.dd. The default is the date of the last error in the error 
log file. If you select the default, then the next dialogue step is 11. 

9 Ending Time <Last Error>? 

Enter the time of the latest error that you want ERRDIS to process. The format 
is hh:mm, either in 24-hour time or with AM/PM afterwards. The default is the 
time of the last error in the error log file on the selected ending date. The next 
dialogue step is 11. 

10 List Bad Blocks (Yes/No) <No>? 

Press Return (or type No) if you do not want ERRDIS to generate a list of 
possible bad blocks following the summary report. Type Yes if you want a list of 
bad blocks. 

(continued on next page) 


Managing System Errors 10-5 









Table 10-1 (Cont.): ERRDIS Dialogue Explanation 

Step Prompt and Description 


11 Zero Error File upon completion (Yes/No) <No>? 

OR: 

Second Message 

At this point, you will be asked one of two questions. If you selected All as the 
answer in Step 5, this question will appear. If you gave a specific error type 
mnemonic as an answer to Step 5, this question will appear as: 

Zero DU Errors upon completion (Yes/No) <No>? 

Type Yes to have ERRDIS zero the previously specified error log file after it 
successfully generates the desired report. (You must type all three characters of 
Yes to zero the file.) 

12 Zero Which Error Type <A11>? 

Press Return or type All to have ERRDIS zero all error types in the file. 
Otherwise, enter the error type or types you want zeroed. 


After you finish the dialogue, ERRDIS: 

• Processes the selected error records 

• Formats and generates the selected report 

• Zeroes the error log file (if requested in step 11 of Table 10-1) 

• Returns to step 2 of Table 10-1. 

At that point, you can enter Ctrl/Z in response to any question to return the 
terminal to the keyboard monitor prompt. 


10.2.2 Help Report 

The Help report prints information on the use of the ERRDIS program and then 
prints a list of the error mnemonics other programs use. After you run ERRDIS 
and select the Help report, the program prints the Help text. 


10.2.3 Summary Report 

A summary report at the end of this section supplies general information on 
all errors logged. The first two columns list the two-character error mnemonic 
and full error description. The TOTAL REC/LOG column lists the total errors 
received by the ERRCPY program and the total it stored in the error file. These 
two totals may differ due to the limits on: 

• The number of errors that may be logged 

• The size of the error file 


The UNIT NUMBERS column lists the total number of errors generated by each 
device on a controller. 

The CONTROLLER ERRORS column indicates how many of the errors logged un¬ 
der TOTAL REC/LOG are controller errors, as opposed to unit errors. (Controller 
errors apply to the controller itself, while unit errors apply to a specific unit 
being controlled.) If N/A appears under CONTROLLER ERRORS, that means 
that ERRDIS is not keeping track of CONTROLLER ERRORS for that particular 
ERROR CODE-DESCRIPTION. 
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The asterisk (*) next to 239/100 indicates that MM, under the ERROR CODE¬ 
DESCRIPTION column, has exceeded the maximum number of errors (100) that 
the Error Package logs for that particular error type. 

After you run ERRDIS and select the SUMMARY report, the program prints the 
summary as follows: 

$ RUN ERROR$:ERRDIS <RET> 

ERRDIS V10.0 RSTS V10.0 EDERE 
Input File <ERROR$:ERRLOG.FIL>? <RET> 

Output to <KB:ERRDIS.OUT>? <RET> 

He[lp], Ba[d Blocks], Su[mmary], Fu[ll] Report or Ze[ro] File <Summary>? <RET> 

List Bad Blocks (Yes/No) <No>? <RET> 

Zero Error File upon completion (Yes/No) <No>? <RET> 

ERRDIS Summary Report taken on 29-May-90, 10:50 AM 

Input File: ERROR$:ERRLOG.FIL Output File: KB:ERRDIS.OUT 


Reported Date/Time Range: 


13-May-90, 

12:21:22 AM through 28-1 

s 

•<J 

1 

O 

12:35:47 AM 

ERROR 

TOTAL 



UNIT 

NUMBERS 

CONTROLLER 

CODE-DESCRIPTION 

REC/LOG 

0 

1 

2 3 

4 5 

6 7 ERRORS 

PF Power Fail/Start 

-up 1/1 





N/A 

DU MSCP Disks 

7/7 


1 


2 

1 3 

DB RH11/RP04-05-06 

3/3 



3 


N/A 

DL RL01/RL02 

3/3 

1 


2 


N/A 

MM RH11/TU16/TE16 

* 239/100 

49 

7 

5 

2 

37 N/A 

SH MSG from SHUTUP 

1/1 





N/A 


Total of 115 Errors Logged out of 254 Received 

34 out of 100 Blocks have been used in ERROR$:ERRLOG.FIL 


******************************************************************** 
Input File <ERROR$:ERRLOG.FIL>? A Z 

$ 


10.2.4 Bad Block Report 

The ERRDET program reports possible bad blocks that were detected by the 
monitor by checking the error logging file for such entries. The criteria for a 
possible bad block depends on the type of disk. 

Each bad block report includes: 

• The logical block number 

• The logical name or pack identification of the disk 

• The physical device name of the disk 

Using the logical block number that ERRDIS prints, you can add the possible 
bad block to the bad block file with the BADS suboption of REFRESH. See the 
RSTS/E System Installation and Update Guide for information on adding bad 
blocks. 
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The following example shows a list of bad blocks that the ERRDIS program 
prints: 

$ RUN ERROR$:ERRDIS <RET> 

ERRDIS V10.0 RSTS V10.0 EDERE 
Input File <ERROR$:ERRLOG.FIL>? <RET> 

Output to <KB:ERRDIS.OUT>? <RET> 

Help, Bad Blocks, Summary, Full Report or Ze[ro] File <Summary>? BAD <RET> 

Zero Error File upon completion (Yes/No) <No>? <RET> 

ERRDIS Bad Block Report taken on 29-May-90, 10:51 AM 

Input File: ERROR$:ERRLOG.FIL Output File: KB:ERRDIS.OUT 
Requested Date/Time Range: 

First Error through Last Error 
ERR0R$:ERRLOG.FIL will not be zeroed upon completion 

List of Possible Bad Blocks: 


Logical Name RAIDER 

Physical Name DM1: 

Logical Block Number 3401 

Logical Name OFTHE 

Physical Name DR4: 

Logical Block Number 237968 

Logical Name LOST 

Physical Name DR5: 

Logical Block Number 432952 

Logical Name ARK 

Physical Name DM2: 

Logical Block Number 8 


Total Number of Possible Bad Blocks: 4 

******************************************************************** 
Input File <ERR0R$:ERRLOG,FIL>? 


NOTE 

Use caution before adding possible bad blocks (that ERRDIS reports) to 
the bad block file. Instead of corrupt disk surfaces, hardware controller 
or disk drive problems may have caused the errors to occur. 


10-2.5 Adding Bad Blocks to the Bad Block File 

The ERRDIS program prints a list of potential bad blocks. If you decide to add a 
block to the bad block file BADB.SYS on a disk, use the BADS suboption of the 
REFRESH option in INIT.SYS (see the RSTS/E System Installation and Update 
Guide). In preparation for adding bad blocks, which requires you to bring the 
system down, use the Peripheral Interchange Program (PIP) system program to 
copy the data in a bad file to a new file. As your system discovers bad blocks, PIP 
lets you collect this information in a single file. You can then use this file to add 
the bad blocks to BADB.SYS when you normally take your system down. 

Follow these steps to use PIP for this purpose: 

1. Specify the /GO switch (along with other necessary switches, such as /CL, and 
so forth) to ignore possible ?Data error on device errors. Rename the file that 
contains the bad block, but do not delete it: 

$ RUN $PIP 

*FILE.TMP=FILE.OLD/GO 
*FILE.BAD=FILE.OLD/RE 
*FILE.OLD=FILE.TMP/R 
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2. When it is convenient, shut down the system and use the BADS suboption 
of REFRESH to add any bad blocks to the disk’s bad block file. Each new 
bad block is now allocated to two files ([0,1]BADB.SYS and FILE.BAD in the 
previous example). 

3. The BADS suboption automatically rebuilds the allocation tables. It then tells 
you the file has a bad block and allows you to delete the file (FILE.BAD in 
the previous example). The RSTS/E Installation and Update Guide describes 
this operation. 

When BADS deletes the file, it frees the blocks in the file that are not bad. 

You must modify the previous procedure if the bad block is in a file directory. In 
this case, use the BACKUP program to copy all accessible files in the account 
(or disk) to an archive medium. When you add the bad block and clean the disk, 
you can delete the account whose directory contains the bad block. After starting 
timesharing, use BACKUP to restore the files from the archive medium. 

The bad block report does not apply to MSCP disks; bad blocks on those devices 
are recovered automatically. 


10.2.6 Full Report 

Each error displayed includes: 

• A title line containing the error code mnemonic 

• The error description 

• A sequence number 

• The date and time the error occurred 

The monitor maintains the sequence numbers, starting at one, from startup 
to shutdown. A crash and subsequent automatic restart does not reset these 
numbers. 

There are four basic categories for individual errors displayed within the full 
error report: 

• Nonperipheral errors such as processor traps and memory parity 

• Disk errors 

• Nondisk peripheral device errors such as magnetic tape errors 

• Other errors such as the shutdown message received from SHUTUP or missed 
errors 

The program automatically checks for and reports possible bad blocks for disk 
errors included in the scan. The following sections contain partial listings of a 
FULL report. 

When the monitor detects a hardware or software error, it sends information 
about the error to the ERRCPY program. ERRCPY can accept and file error 
information until the number of queued errors reaches 40. The monitor logs all 
errors it detects beyond this point as "missed errors." Only after the queue begins 
to empty and the number of errors queued to ERRCPY falls below the maximum 
of 40 can the monitor begin to send the normal error information. This means 
that while the queue is full, the monitor reports all subsequent errors as "missed 
errors," rather than sending the usual error information to ERRCPY. 
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The monitor also reports missed errors if it does not have a sufficient number of 
general small buffers available to store error information. When the number of 
general small buffers drops below 75, the monitor reports any detected error to 
ERRCPY as a "missed error." 


10.2.6.1 User Description in Full Report 

All errors except shutdown, missed errors, and some MSCP controller errors 
usually include a user description. The name fields in the user description relate 
to a specific job whose number appears in the first field (Job number). (Under 
certain conditions, a job number of 0 is possible. In this case, the user description 
is not listed.) 

The following example shows a complete error report for a tape device; the 
report includes both a user description and a detailed description and Table 10-2 
summarizes the user description data: 

$ RUN ERROR$:ERRDIS <RET> 

ERRDIS V10.0 RSTS V10.0 EDERE:: 

Input File <ERROR$:ERRLOG.FIL>? <RET> 

Output to <KB:ERRDIS.OUT>? <RET> 

Help, Bad Blocks, Summary, Full Report or Ze [ro] File <Summary>? FULL <RET> 

Specific Error Type <A11>? <RET> 

Starting Date <First Error>? 13-May-90 <RET> 

Ending Date <Last Error>? <RET> 

Zero Error File upon completion (Yes/No) <No>? <RET> 

ERRDIS Full Report (All Types) taken on 29-May-90, 02:17 PM 

Input File: ERROR$:ERRLOG.FIL Output File: KB:ERRDIS.OUT 

Requested Date/Time Range: 

13-May-90 (First Error) through Last Error 
ERROR$:ERRLOG.FIL will not be Zeroed upon completion 

******************************************************************** 

MM RH11/TU16/TE16 Seq #92 Occurred on 28-May-90 at 02:11:44 PM 

User Description: 


Job Number 

18 

KB Number 

2 

Account 

[1,170] 

Program Name 

PASIKO 

User Job Physical Addr. 

02310000 

User Job Size 

28K 

Control Parameters 

200 

RTS Name 

RT11 

RTS Physical Address 

01714000 


Detailed Description: 


Timeout Indicator 

000 




Physical Name 

MM0: 




DDB 

017600 

173444 

104252 

000011 


045471 

005171 

001630 

177400 


000000 

147240 

000000 

001007 


000056 

002004 

127311 


CSR Address: 

176700 
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Contents 

of Registers: 


MTCS1 

145270 

TRE Xfer Err 

MTWC 

000400 


MTBA 

132444 


MTFC 

000000 


MTCS2 

000100 


MTDS 

150660 

PE Mode 

MTER 

100000 

COR/CRC 

MTAS 

000001 


MTCK 

000000 


MTMR 

000000 


MTDT 

000000 

TU77 TM03 

MTSN 

000000 


MTTC 

000000 


MTBAE 

000016 


MTCS3 

002000 



Table 10-2: 

User Description Data 

Heading 

Meaning 


Job Number For disk errors, the number of the job that requested the 

I/O; for nondisk peripheral errors, the job owning the 
device; for nonperipheral errors, the job running at the time 
of the error. 


KB Number 


The keyboard number of the job, followed by DET if the job 
is detached. 


Account 
Program Name 

User Job Physical Address 
User Job Size 

Control Parameters 1 
RTS Name 

RTS Physical Address 


The PPN of the user who created the job. 

The name of the program running in the job virtual address 
space (low segment). 

The current physical memory address of the job. 

The size of the user program running in the low segment of 
the job virtual address space. 

Monitor control information. 

The name of the run-time system mapped into the highest 
segment of the user's virtual address space. 

The address of the location in physical memory where the 
run-time system resides. 


1 A detailed description of this entry is beyond the scope of this manual. The entry is intended for 
use by Digital personnel. 
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10.2.6.2 Disk Error Detailed Description 

A full report for a disk error includes three sections: 

• User description 

• Detailed description 

• Contents of registers 


Table 10-3 describes the information found in the detailed description portion of 
a disk error report. Before you refer to the table, study the following example. 
The example shows what a single complete disk error looks like. If the entire 
Full Report of DB type errors were reproduced here, you would see two more 
identically structured error messages following this one. As you can tell from the 
sample in the section "Summary Report," there are three DB errors under TOTAL 
REC/LOG. The example follows: 


$ RUN ERROR$:ERRDIS <RET> 

ERRDIS V10.0 RSTS V10.0 EDERE 
Input File <ERROR$:ERRLOG.FIL>? <RET> 

Output to <KB:ERRDIS.OUT>? <RET> 

Help, Bad Blocks, Summary, Full Report or Ze[ro] File <Summary>? FULL <RET> 
Specific Error Type <A11>? DB <RET> 

Starting Date <First Error>? 13-May-90 <RET> 

Starting Time <First Error>? <RET> 

Ending Date <Last Error>? <RET> 

Zero Error File upon completion (Yes/No) <No>? <RET> 

ERRDIS Full Report (DB only) taken on 29-May-90, 11:00 AM 

Input File: ERROR$:ERRLOG.FIL Output File: KB:ERRDIS.OUT 

Requested Date/Time Range: 

13-May-90 (First Error) through Last Error 
ERROR$:ERRLOG.FIL will not be Zeroed upon completion 

******************************************************************** 

DB RH11/RP04-05-06 Seq #81 Occurred on 28-May-90 at 07:12:14 AM 

User Description: 


Job Number 

KB Number 

Account 

Program Name 

User Job Physical Addr. 

User Job Size 

Control Parameters 

RTS Name 

RTS Physical Address 


17 

33 (Det) 
[ 1 , 100 ] 
LOGOUT 
02744000 
11K 
200 

...RSX 
00000000 


Detailed Description: 


I/O Status 
Timeout Indicator 
Offset Position 
Overlapped Seek Ind. 
Unit Size in DC's 
Device Cluster Size 
Pack Cluster Size 
Logical Name 
Physical Name 
Logical Block Number 

DSQ 


000 

000 

Previous 

377 

121510 

8 

8 

D 


DB2: 


19272 


004500 

173442 

045501 

006171 

000000 

146300 

000056 

002004 


104252 000011 
064540 174000 
000000 001000 
127310 001003 
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WCB 


FCB 


CSR Address: 


100000 

004442 

000002 

000021 

146274 

000000 

000000 

001310 

113570 

004550 

004551 

005165 

005166 

005413 

005414 

005415 

147040 

070560 

000544 

076725 

064511 

077430 

037404 

000001 

001300 

113570 

001270 

113570 

000011 

000226 

000010 

146300 

176700 





Contents of Registers: 


RPCS1 

RPWC 

RPBA 

RPDA 

RPCS2 

RPDS 

RPER1 

RPAS 

RPLA 

RPMR 

RPDT 

RPSN 

RPOF 

RPDC 

RPCC 

RPER2 

RPER3 

RPEC1 

RPEC2 


145270 

000400 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 

000000 


TRE Xfer Err 


Not Ready 
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Table 10-3 describes the information found in the detailed description portion of 
the previous disk error report. The program prints an additional field if the error 
signalled a possible bad block. 


Table 10-3: Disk Error Detailed Description 


Heading 

Meaning 

I/O Status 

Timeout Indicator 

See following Timeout Indicator. 

Timeout and I/O Status are considered as a pair. One of the 
following states can exist: 

Timeout Indicator I/O Status Meaning 

0 0 Idle 

Offset Position 

x 1 SEEK in progress 

0 1 Waiting for Read/Write 

1 x Timeout 

where x equals any nonzero value. 

The contents of Offset Position for disks having offset capabilities: 

0 = centerline position 

20 = +x offset 

220 = -x offset 

40 = +2x offset 

240 = -2x offset 

60 = +3x offset 

260 = -3x offset 

100 = offset unknown 

Overlapped Seek 

Ind. 

where x equals the number of micro inches of offset (a drive 
dependent parameter). 

377 = overlap seek driver 

000 = non-overlap seek driver 

You determine which of these two values appears during system 
installation. 

Unit Size in DC’s 

Device Cluster Size 

Pack Cluster Size 

Logical Name 

Size (in octal) of the disk expressed as the number of device clusters. 
Device cluster size for this drive. 

Pack cluster size for this disk. 

The pack identification if no system wide logical name was given at 
mount time or the system logical name entered at mount time. 

Physical Name 

Logical Block 
Number 

DSQ 1 

WCB 1 

The physical name and unit number. 

The block number where the error occurred. 

The disk request queue entry block. 

The WCB (Window Control Block) is present for disk errors that 
resulted from a file request by the user job. 

FCB 1 

CSR Address 

The File Control Block. 

The CSR address is the base address of the set of registers in the 
I/O page belonging to the device that caused the error. 


1 A detailed description of this entry is beyond the scope of this manual. The entry is intended for 

use by Digital maintenance personnel. 


(continued on next page) 
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Table 10-3 (Cont.): Disk Error Detailed Description 


Heading Meaning 

Contents of This section contains the name of each readable device register, 

Registers its contents and, possibly, an abbreviated description of various 

error bits that were found to be set to one in the register. ERRDIS 
stores a maximum of 21 error bits for each error type. The data 
file ERRDAT.FIL contains the register mnemonics, error bit de¬ 
scriptions, and error code descriptions for all error types. ERRDIS 
requires this file to run. 

See the PDP-11 Peripherals Handbook for a detailed description of 
registers and bit descriptions. The register mnemonics displayed by 
ERRDIS correspond to those given in the manual. 


10.2.6.3 MSCP Variations on the Full Report 

For systems that support MSCP type disk hardware, (for example, the RA80), 
there are these variations on the Full Report: 

• If there is a disk error, then the Full Report looks just like the normal Full 
Report, except that it has two extra sections called the MSCP Description and 
the Driver Related Data (see Example #1). The Full Report includes these 
sections: 

— User Description 
— Detailed Description 
— Contents of Registers 
- MSCP Description 
— Driver-related Data 

• If there is a controller error, then the Full Report shows an abbreviated error 
message. The Full Report does not have a User Description, and its Detailed 
Description is not as large as in the normal Full Report (see Example #2). 
The Full Report includes these sections: 

— Detailed Description 

— Contents of Registers 

— MSCP Description 

— Driver-related Data 

If you refer back to the sample report in the section "Summary Report," you will 
notice that the first example that follows is the error that was logged under UNIT 
NUMBER 1. The second sample error message that follows is one of the three 
errors logged under CONTROLLER ERRORS. 
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Example #1: 

$ RUN ERROR$:ERRDIS <RET> 

ERRDIS V10.0 RSTS V10.0 EDERE 
Input File <0,3]ERRLOG.FIL>? <RET> 

Output to <KB:ERRDIS.OUT>? <RET> 

Help, Bad Blocks, Summary, Full Report or Ze [ro] File <Summary>? FULL <RET> 
Specific Error Type <A11>? DU <RET> 

Starting Date <First Error>? <RET> 

Ending Date <Last Error>? <RET> 

Zero Error File upon completion (Yes/No) <No>? <RET> 

ERRDIS Full Report (DU only) taken on 29-May-90, 02:17 PM 

Input File: ERR0R$:ERRLOG.FIL Output File: KB:ERRDIS.OUT 

Requested Date/Time Range: 

First Error through Last Error 
ERROR$:ERRLOG.FIL will not be Zeroed upon completion 

******************************************************************** 

DU MSCP Disks Seq 46 Occurred on 25-May-90 at 07:04:02 PM 

User Description: 


Job Number 12 

KB Number 16 

Account [1,217] 

Program Name PACKID 

User Job Physical Addr. 01610000 

User Job Size 7K 

Control Parameters 000 

RTS Name BAS4F 

RTS Physical Address 01514000 


Detailed Description: 


I/O Status 000 

Timeout Indicator 377 

Offset Position 000 

Overlapped Seek Ind. 000 

Unit Size in DC's 000000 

Device Cluster Size 0 

Pack Cluster Size 0 

Logical Name 


Physical Name 

DU7 : 




Logical Block Number 

200806 




DSQ 

000000 

177430 

103664 

001424 


010147 

000367 

023000 

000400 


000010 

000000 

000000 

075576 


000003 

004000 

000000 

003777 

CSR Address: 

160414 





Contents of Register: 


SA 000000 Controller On Line 

MSCP Description: 


Packet Type 

End Message 



MSCP 

Envelope 

000060 

000001 



MSCP 

Packet 

074130 

140416 

000007 

000000 



000203 

000043 

000736 

000000 



000000 

000000 

001624 

000000 



020424 

001003 

031431 

020144 



000007 

000000 

000037 

000001 



000001 

003400 

000020 

002001 
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Command Reference Number 

Drive Number 

Message Flags 

End Flags 

Endcode 

Status/Event Code 
First Bad Block 


074130 140416 
000007 
000 
000 

203 GET UNIT STATUS command 

000043 No vol mntd or r/s switch out 
543437593. 


Driver Related Data: 


Internal Control Status Word 
Internal Unit Status Word 
Driver Error Code 
BBR Flag Word 


000300 

000000 

000007 

000000 


GUS failed; unit not functional 


Example #2: 


$ RUN ERR0R$:ERRDIS <RET> 

ERRDIS V10.0 RSTS V10.0 EDERE 
Input File <ERR0R$:ERRLOG.FIL>? <RET> 

Output to <KB:ERRDIS.0UT>? <RET> 

Help, Bad Blocks, Summary, Full Report or Ze[ro] File <Summary>? FULL <RET> 
Specific Error Type <A11>? DU <RET> 

Starting Date <First Error>? <RET> 

Ending Date CLast Error>? <RET> 

Zero Error File upon completion (Yes/No) <No>? <RET> 

ERRDIS Full Report (DU only) taken on 29-May-90, 02:19 PM 

Input File: ERROR$:ERRLOG.FIL Output File: KB:ERRDIS.OUT 

Requested Date/Time Range: 

First Error through Last Error 
ERROR$:ERRLOG.FIL will not be Zeroed upon completion 


******************************************************************** 
DU MSCP Disks Seq 2 Occurred on 21-May-90 at 12:59:04 PM 

Detailed Description: 


I/O Status 000 

Timeout Indicator 377 

CSR Address: 172150 


Contents of Register: 

SA 000000 Controller On Line 

MSCP Description: 

MSCP Packet Type Last Fail Packet 


MSCP Envelope 000030 

MSCP Packet 000000 

000400 

000000 

Controller Class 001 

Controller Model 006 

Controller Hardware Version 000 
Controller Software Version 004 
UDA Internal Error Code 000013 


Driver Related Data: 


Internal Control Status Word 000102 
Internal Unit Status Word 000000 
Driver Error Code 000000 
BBR Flag Word 000000 

*********************************** 


000020 

000000 000000 000000 
000012 000000 000000 
000406 000004 000013 

Mass Storage 
UDA50-A 


ER.MST - Bus Master Error 


Driver did not detect error 

******************************** 
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10.2.6.4 Nondisk Peripheral Device Error Detailed Description 

Table 10—4 lists the fields found in the detailed description portion of the nondisk 
peripheral device error report. Before you refer to the table, study the following 
example. The example shows a single complete tape error. As you can tell from 
the example in the section "Summary Report," this is one of the 239 tape errors 
that were received. This particular error was one of the 100 logged, and also one 
of the seven logged under UNIT NUMBER 1. The entire Full Report contains 99 
more tape error messages. The example follows: 

$ RUN ERROR$:ERRDIS <RET> 

ERRDIS V10.0 RSTS V10.0 EDERE 
Input File <ERROR$:ERRLOG.FIL>? <RET> 

Output to <KB:ERRDIS.OUT>? <RET> 

Help, Bad Blocks, Summary, Full Report or Ze[ro] File <Summary>? FULL <RET> 

Specific Error Type <A11>? MM <RET> 

Starting Date <First Error>? <RET> 

Ending Date <Last Error>? <RET> 

Zero Error File upon completion (Yes/No) <No>? <RET> 

ERRDIS Full Report (MM only) taken on 29-May-90, 02:17 PM 

Input File: ERROR$:ERRLOG.FIL Output File: KB:ERRDIS.OUT 

Requested Date/Time Range: 

First Error through Last Error 
ERROR$:ERRLOG.FIL will not be zeroed upon completion 

******************************************************************** 

MM RH11/TU16/TE16 Seq #44 Occurred on 28-May-90 at 05:51:08 AM 

User Description: 


Job Number 

ii 



KB Number 

33 (Det) 



Account 

[1,100] 



Program Name 

BACKUP 



User Job Physical Addr. 

02610000 



User Job Size 

15K 



Control Parameters 

200 



RTS Name 

...RSX 



RTS Physical Address 

00000000 



Detailed Description: 




Timeout Indicator 

000000 



Physical Name 

MM1: 



DDB 

000016 000426 

002102 

100001 


000001 000000 

000000 

000000 


105536 120540 

010004 

000021 


000361 001002 

010760 

000053 


000000 007314 

004400 


CSR Address: 

172440 




Contents 

of Registers: 


MTCS1 

145260 

TRE Xfer 

MTWC 

000000 


MTBA 

010004 


MTFC 

000000 


MTCS2 

000100 


MTDS 

150760 

PE Mode 

MTER 

100000 

COR/CRC 

MTAS 

000001 


MTCK 

000010 


MTMR 

001100 


MTDT 

142011 

TU16/TE16 

MTSN 

060023 


MTTC 

102301 
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Table 10-4 describes the information found in the detailed description portion of 
the previous nondisk peripheral device error report example. 


Table 10-4: Nondisk Peripheral Device Format 


Heading 

Meaning 

Timeout Indicator 

Nonzero indicates that an expected response was not received 

from the device in the allotted time. 

Physical Name 

The physical name and unit number of the device. 

DDB 1 

The DDB (Device Data Block) contains various parameters 
required by the system to control the device. 

DDB Extension 1 

Supplementaiy DDB information. 

CSR Address 

The CSR address is the base address of the set of registers in 
the I/O page belonging to the device that caused the error. 

Contents of Registers 

This section contains the name of each readable device 
register, its contents and, possibly, an abbreviated description 
of various error bits that were found to be set to one in the 
register. ERRDIS stores a maximum of 21 error bits for each 
error type. The data file ERRDAT.FIL contains the register 
mnemonics, error bit descriptions, and error code descriptions 
for all error types. ERRDIS requires this file to run. 


See the PDP-11 Peripherals Handbook for a detailed de¬ 
scription of registers and bit descriptions. The register 
mnemonics displayed by ERRDIS correspond to those given 
in the manual. 

X A detailed description of this entry is beyond the scope of this manual. The entry is intended for 

use by Digital maintenance personnel. 


10.2.6.5 Nonperipheral Error Detailed Description 

See the related processor handbook for detailed descriptions of nonperipheral 
error fields. Table 10-5 gives an abbreviated description of these items. Before 
you refer to the table, study the following example. This example shows a single 
complete error message extracted from the ERRLOG.FIL using ERRDIS to 
reproduce only the PF type errors: 

$ RUN ERROR$:ERRDIS <RET> 

ERRDIS V10.0 RSTS V10.0 EDERE 
Input File <ERROR$:ERRLOG.FIL>? <RET> 

Output to <KB:ERRDIS.OUT>? <RET> 

Help, Bad Blocks, Summary, Full Report or Ze[ro] File <Summary>? FULL <RET> 

Specific Error Type <A11>? EF <RET> 

Starting Date <First Error>? <RET> 

Ending Date <Last Error>? <RET> 

Zero Error File upon completion (Yes/No) <No>? <RET> 

ERRDIS Full Report (PF only) taken on 29-May-90, 02:21 PM 

Input File: ERROR$:ERRLOG.FIL Output File: KB:ERRDIS.OUT 

Requested Date/Time Range: 

First Error through Last Error 
ERROR$:ERRLOG.FIL will not be zeroed upon completion 

******************************************************************** 

PF Power Fail/Start-up Seq #1 Occurred on 13-May-90 at 02:15:01 PM 
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Detailed Description: 


R0 

000000 

R1 

004200 

R2 

000000 

R3 

000002 

R4 

004100 

R5 

000000 

Virtual PC 

000077 

Physical PC 

00000077 

Processor Status 

000000 

Stack Pointer 

002074 

(SP) 

000002 

(SP+2) 

000000 

(PC-6) 

034156 

(PC-4) 

004356 

(PC-2) 

034156 

(PC) 

004357 

CPU ID 

-1 

CPU ERR 

000000 


Table 10-5 describes the information found in the detailed description portion of 
the previous example. 


Table 10-5: Nonperipheral Error Format 


Heading 

Meaning 

R0-R5 

Processor registers 0 through 5. Each register is listed on a 
separate line. 

Virtual PC 

The address (within the user virtual address space) of the 
instruction being executed at the time of the error. 

Physical PC 

The address (in the physical memory address space) of the 
instruction being executed at the time of the error. 

Processor Status 

The processor status word. 

Stack Pointer 

The address of the current top of stack. 

(SP) 

(SP+2) 

The contents of the top two words in the stack. 

(PC-6) 

(PC-4) 

(PC-2) 

(PC) 

The contents of the three words preceding the current 
program PC and the contents of the current PC. 

CPU ID 

If it exists, the contents of the CPU identification register. 

CPU ERR 

If it exists, the contents of the CPU error register. 

MED X 

If it exists, the CPU has Maintenance Examine/Deposit 
Instruction. 

Contents of Registers 

Certain nonperipheral errors include contents of key regis¬ 
ters. The format is identical to the contents of registers for 
disk and nondisk peripheral errors. 


NOTE 

The PF error code is used for recording both startup and power fail 
recovery. The error log for a normal startup has a sequence number of 
1. For a power fail restart, the sequence number is greater than 1. 
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10.2.6.6 Understanding M PA Memory System" Errors 

The following information is logged when a memory error causes a trap or an 
instruction abort. These logs can be recognized by the fact that "MEM ERR" is 
not zero: 


CACHECTL 

This is the data RSTS/E sets into the Cache Control Register (777746). 
It is meaningless for systems not using cache memory. 

ADDR LSB 

ADDR MSB 

These words contain the address of the word in memory that failed. 

On the PDP-11/70, they are the contents of the Low Error Address 
Register (777740) and High Error Address Register (777742). Bits 
<15:14> of ADDR MSB indicate the cycle type of the failure. On 
other processors, these words are assembled from the other logged 
information. 

MEM ERR 

On processors with cache, this is the contents of the Memory System 
Error register (777744). On other processors, this word always contains 
100000 (CPU Abort, no cache error). If the same cache group fails 
twice in the same minute, that cache group will be disabled. 


The remaining registers are not logged on the 11/70, which does not have accessible 
memory CSRs. In any case, they are not meaningful unless the error occurred in main 
memory. 


CSR 

(CSR) 

This is the address of the CSR that indicated an error. 

This is the contents of that CSR. A second entry is also printed for an 
MS11M or MS11L with the extended address function selected. 

K Range 

This indicates how finely the CSR contents can resolve the location 
of the error. For all current memory controllers (MF11-LP, MF11-UP, 
MF11-WP, MF11S-K, MM 11-DP, MM11-YP, and MS11-JP), this value 
is 1, indicating that the CSR locates the error to within IK words. 

For older semiconductor memory controllers (MS11-AP, MS11-BP, and 
MS11-CP) that do not provide the address of the error in the CSR, this 
value is the number of IK-word blocks (up to 31.) controlled by the 
CSR. 

# Fail 

When RSTS/E discovers a CSR announcing an error, RSTS/E looks 
through all memory in the range of the error (see above) to find which 
words actually have errors. Thus, for a controller that resolves the 
error location to within IK- words, RSTS/E checks 1024 words (or 512 
words if the memory is interleaved). This word indicates how many 
words within the range actually had an error indication. 

Base Adr 

To get the physical address of the start of the range mentioned above, 
add two zero digits (six bits) to this value. 

Fail #n 

The next words in the error log indicate which words within the given 
range actually have errors. The addresses are given as byte offsets 
from the base given above. Up to five such offsets may be logged. 


Once a second, except on 11/70’s, RSTS/E checks all memory CSRs for errors that 
do not cause traps or aborts. The logs for these errors can be recognized by the 
fact that "MEM ERR" is zero. These errors include uncorrectable errors detected 
on NPR cycles, and correctable (single-bit) ECC errors. Uncorrectable errors are 
logged whenever they are detected, but only one correctable error is logged for 
each CSR, for each time RSTS/E is started. When a correctable error is logged, 
only the CSR address and CSR contents are meaningful. 
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10.2.7 Zero File 

The Zero File option of ERRDIS lets you clear any or all types of errors from 
the ERRLOG.FIL file without generating a report. After you select this option, 
ERRDIS prompts you for the error type to zero. The default is to zero all error 
types. Enter the two-character mnemonic for the error type you wish to clear, or 
type Return to accept the default. The following example shows how to clear all 
DB errors: 

$ RUN ERROR$:ERRDIS 

ERRDIS V10.0 RSTS V10.0 EDERE 

Input File <ERROR$:ERRLOG.FIL>? 

Output to <KB:ERRDIS.OUT>? 

He[lp], Ba[d Blocks], Su[mmary], Fu[ll] Report or Ze[ro] File <Summary>? ZERO 
Zero Which Error Type <A11>? DB 

Input File <ERROR$:ERRLOG.FIL>? 


10.3 Analyzing System Crashes: ANALYS 

Timesharing operations halt when a crash occurs on a RSTS/E system. The 
system then writes an image of read/write memory, tables, and XBUF to the 
CRASH.SYS file in account [0,1]. The system bootstraps the system disk, loads 
the initialization code into memory, and executes an automatic restart if the CPU 
switch register has bit 0 set. 

Unless you run the ANALYS program to save crash dump information, the next 
system crash causes the CRASH.SYS file to be overwritten and the information in 
the file to be lost. Normally, this is done as part of system startup. See Chapter 2 
for a description of automatic system recovery procedures. 

The crash analysis program ANALYS consists of these modules: 

• ANALYS 

• ANALY1 

• ANALY2 

• ANALY3 

For simplicity, the documentation refers to only one program, ANALYS, which 
functionally includes all the modules. 


10.3.1 Running the ANALYS Program 

Run the ANALYS system program by typing this command: 

$ RUN ERROR$:ANALYS<RET> 

After you press Return, the ANALYS program prints an identification line and 
three dialogue questions: 

ANALYS V10.0 RSTS V10.0 EDERE 
INPUT <[0,1]CRASH.SYS>? <RET> 

OUTPUT <ANALYS . DMP<188»? <RET> 

Crash error log filename<ERROR$:ERRCRS.FIL>? <RET> 

$ 
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The ANALYS program uses the following switches: 

• /DET tells ANALYS to detach. 

• /[NO]DUMP tells ANALYS whether or not to include a memory dump in its 
output. The default is /DUMP. 

• /NARROW tells ANALYS whether to use 80 or 132 columns in its output. The 
default is 132. 

• /NOSTB tells ANALYS not to include the symbol table in its output. 

• /NOXBUFDUMP tells ANALYS not to include the octal dump of XBUF. It 
also implies a /DUMP, so you do not need to include /DUMP with it. 

• /SIL lets Digital engineering analyze the crash and .SIL files submitted with 
a Software Performance Report (SPR). 

Table 10-6 explains how to answer the ANALYS program questions. 

Table 10-6: ANALYS Program Dialogue 


Question and Response 

INPUT <[0,1]CRASH.SYS>? 

Asks for the name of the file to be analyzed. Type the file specification of 
the file you want ANALYS to analyze, which by default is CRASH.SYS in 
account [0,1]. Press Return to accept the default response. However, you 
may want to keep copies of different crash files. 

ANALYS uses the currently installed monitor SIL file to extract symbolic 
references. If the crash file being analyzed is not associated with the 
currently installed monitor, you must append the /SIL: switch with the 
name of the related monitor SIL. This switch allows Digital to analyze crash 
and .SIL files submitted with a Software Performance Report (SPR). 


OUTPUT <ANALYS.DMP<188»? 

Requests a disk file or a device designator for the output medium. You 
can select the default output file ANALYS.DMP by pressing Return. Enter 
another file specification if you do not want ANALYS to place the output 
in the default account. ANALYS always prints an annotated version of a 
memory dump and automatically prints a memory dump in 132-column 
format unless you: 

1. Request output to your terminal (for example, KB ANALYS.DMP). 

2. Append the /NODUMP switch to omit the memory dump. 

3. Append the /NOXBUFDUMP switch to omit the octal dump of XBUF. 

4. Append the /NARROW switch to a file specification (or type /NARROW 
and press Return in response to the OUTPUT question if you want 
ANALYS.DMP to be the output to be the output file) for 80-column 
output. 

5. Append the /NOSTB switch to omit the symbol table. Do not use this 
switch when submitting an SPR. 

In any case, you get the annotated output in 80-column format, but with 
fewer memory locations printed on each line. If you do not want a dump of 
memory, append the /NODUMP switch to your response. 


(continued on next page) 
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Table 10-6 (Cont.): ANALYS Program Dialogue 


Question and Response 

Crash error log filename<[0,3]ERRCRS.FIL>? 

Asks for the file specification of the file you want to hold certain error 
information from the crash file. Press Return to have ANALYS write this 
information to the ERRCRS.FIL in the error package account [0,3]. 

Note that the /DET qualifier causes ANALYS to detach. 

ANALYS retrieves error information saved at the time of a system crash 
but not written to the system error logging file ERRLOG.FIL. The ERRDIS 
program accepts the file you specify as input and produces an error log 
report from its contents. To retain a single continuous error logging file, use 
the ERRINT option. 


Normally, ANALYS takes more than 30 minutes to run. When the output stops, 
the program automatically terminates and returns to the keyboard monitor 
prompt. 


10.3.2 ANALYS Output 

Output of the ANALYS system program supplies valuable hardware and software 
information that a software specialist can use to determine possible causes of 
system crashes. This output includes: 

• A report similar to SYSTAT 

• A memory dump of the critical contents of memory 

• A listing of all monitor symbols 

The report also contains DECnet/E information if you configured your system 
with DECnet/E. See the RSTS/E Utilities Reference Manual for an explanation of 
SYSTAT. 
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Table 10-7 shows the error codes that ANALYS reports in the crash dump data. 


Table 10-7: System Crash Error Code 


Error Cod© (Octal) 

Meaning 

-1(177776) 

-2(177776) 

-3(177775) 

Power fail error. 

Jump to 0. 

This code is returned when RSTS/E does a crash dump as a 
result of halting the CPU and continuing from location 52 
(octal). 

-4(177774) 

This code is returned when RSTS/E detects an unrecoverable 
problem and forces a software crash. This can be caused by 
either a RSTS/E software problem or faulty hardware. 

41 

Trap to 4. 

42 

43 

Trap to 10. 

Trap to 250 (Memory management violation). 

44 

46 

Kernel SP Stack overflow. 

Trap to 114 (Parity memory error). 


To obtain crash information printouts automatically, include the proper commands 
in the START.COM file. The commands run ANALYS to preserve the crash 
information and run ERRDIS to create a report. See Chapter 3 for a description 
of the commands you should include in the START.COM file. 
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Chapter 11 

Device Management and Caching Control 


This chapter introduces the concepts of device management and caching control 
on your RSTS/E system. Later, it explains DCL commands available to you in 
more detail. Table 11-1 summarizes these DCL commands. 


Table 11-1: DCL Commands for Device Management and Caching Control 


Command 

Meaning 

Device Management 

ALLOCATE 

DEALLOCATE 

SET DEVICE 

SET PRINTER 

SHOW DEVICE 

SHOW DISKS 

SHOW PRINTER 

Allocates a device and optionally assigns it a logical name 
Deallocates the specified device 

Sets the characteristics for the specified device 

Set the characteristics of the specified line printer 

Displays information about the specified device 

Displays the status of all mounted disks 

Displays the characteristics of the specified printer 

Caching Control 

SET CACHE 

SHOW CACHE 

CREATE AHTUAL_DISK 

DELETE/VIRTUAL_DISK 

Enables data and directory caching 

Displays the current cache settings 

Reserves a section of memory for use as a virtual disk 

Frees the section of memory reserved for the virtual disk 


11.1 Principles of Device Management 

Use the SET DEVICE command to set device attributes. You need HWCTL, 
HWCFG, and DEVICE privileges to use the SET DEVICE command. 

You can disable a specific device for the current timesharing session with the 
/DISABLE qualifier to the SET DEVICE command. To disable a device for 
subsequent sessions, use the SET DEVICE command in the START.COM file. To 
reenable a disabled device, use the /ENABLE qualifier. 

The /RESTRICT qualifier limits the use of the specified device to users with 
DEVICE privilege. The /NORESTRICT qualifier lets any user allocate or open 
the specified device. 
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11.2 Optimizing Disk Directory Structure: REORDR 


The REORDR program can restructure the disk directories on your system to 
improve disk access time. This process begins once you run REORDR and answer 
the set of questions in its dialogue. The following sections discuss: 

• Operations that REORDR performs 

• Dialogue questions and responses 

• Restructuring the public disk structure 

• Error and processing messages 

• REORDR Example 


11-2.1 Why Use REORDR? 

The system catalogues RSTS/E files on disk in user file directories (UFD). As you 
create, delete, and extend files, the file directory entries become scattered across 
the surface of the disk. This scattering increases both the time to open files and 
the time to retrieve data blocks. 

The REORDR program can perform three operations to restructure disk directo¬ 
ries. Each of these operations can improve the performance of your system. After 
you run the program and answer a sequence of dialogue questions, REORDR 
performs the following: 

1. Places the list of file names in as few physical disk blocks as possible. This 
reduces the number of directory accesses the system needs to make for a file 
open operation. 

2. Attempts to place all directory information concerning the physical location 
of file data (retrieval pointers) for a file into contiguous disk blocks. This 
reduces the number of disk directory accesses required to perform disk read 
and write operations. 

3. Optionally sorts the file name list in one of four ways, depending on how you 
answer the dialogue questions. This reduces the number of directory accesses 
the system needs to make for a file open operation. 

When RSTS/E creates a new file in an account, it adds the file name at the end 
of the current directory list. That is, RSTS/E places files last in the directory if, 
during disk initialization, you typed NO to the DSKINT question NEW FILES 
FIRST (see the RSTS/E System Installation and Update Guide). Answering 
Yes, while not efficient under most situations, may be more efficient for your 
installation. You should have new files first only if users on your system do not 
create many new files and their accounts are not large. Otherwise, because of the 
way RSTS/E retrieves user directory information, it is more efficient to have new 
files last. With the REORDR program, you can choose to organize files by access 
date or creation date. 

Note that DCL opens all work files in DCLWRK$:, or in your own account if 
DCLWRK$: does not exist. In either case, the account with this file in it cannot 
be reordered. 
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11.2.2 Dialogue Questions and Responses 


The REORDR program prints a set of questions after you type RUN 
AUXLIB$:REORDR: 

$ RUN AUXLIB$:REORDR 

REORDR V10.0-L RSTS V10.0-L EDERE 

Directory Reordering Program 

Sort Directory(s) (YES/NO) <NO>? YES 

Order by CRE[ATION], ACC[ESS] Date or FIL[ENAME] <CRE>? FIL 

Order by FIL[ENAME] or TYP[E] <FIL>? FIL 

In FOR[WARD] or REV[ERSE] Order<FOR>? FOR 

Device and UFD Specification(s)? SYO:[100,100] 

Directory SYO:[100,100] has been Reordered 

Sort Directory(s) (YES/NO) <NO>? A Z 

$ 

Table 11-2 summarizes these questions and their responses. 

Table 11-2: REORDR Dialogue Questions 


Question and Response 
Sort Directory(s) (YES/NO) <NO>? 

Type NO or press Return to keep the existing order of the accounts) you are 
processing. Either response causes REORDR to skip the next two questions. 
Type YES to have REORDR sort the account(s) you designate. REORDR 
asks the next two questions to determine how you want the accounts) 
sorted. 


Order by CRE[ATION] OR ACC[ESS] Date<CRE>? 

Type CRE or press Return to have REORDR sort the account(s) by creation 
date. Type ACC to have REORDR use ACCESS date to sort the accounts). 
Depending on how the disk was initialized, the access date can have one of 
two meanings. It can mean: 

• When the file was last accessed 

• When it was last modified 

Note that the abbreviation DLW in the comments part of the SHOW DISKS 
command or the DISPLY program shows that a disk’s access date is set to 
the date of last modification. 


In FOR[WARD] or REV[ERSE] Order<FOR>? 

Type FOR or press Return if you want REORDER to sort oldest files first. 
Type REV to have REORDR create a sorted file with newest files first. 

(continued on next page) 
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Table 11-2 (Cont.): REORDR Dialogue Questions 


Question and Response 
Device and UFD Specification(s)? 

Enter the device mnemonic(s) and unit number(s) of the device(s) you want 
REORDR to process. Include the account(s) you are reordering with the 
device designator. For example, the specification DB0:[1,210],DB1:[*,210] 
is a valid response. Although SY: (indicating the entire public structure) is 
not a valid device, SYO: (indicating the system disk, the device that was 
bootstrapped) is acceptable for the device response. An asterisk (*) is a 
valid character in either or both of the project-programmer account fields. 

It tells REORDR to process all project or all programmer numbers on the 
device. You can also include multiple specifications if you separate them 
with commas (,). The account designators are: 

• [*,*] 

Process all user file directories on the disk 

• [p,*] 

Process all user file directories with project number p 

• [*,pn] 

Process all user file directories with programmer number pn 

• [p,pn] 

Process only the user file directory with project number p and program¬ 
mer number pn 


NOTE 

For disks initialized prior to V8.0, REORDR cannot order account [1,1], 
even though it may be implicit in an account designation. 


11.2.3 Reordering Your Disks 

To reorder all disks in the public disk structure, you must include the device 
designator for each disk and the account numbers of the files you want reordered: 

Device and UFD Specification(s)? DBO:[*,*], DB1:[*,*] 

REORDR orders all the directories in the UFD on RP06 unit 0 and then all the 
directories in the UFD on RP06 unit 1. Make sure you logically mount the disks 
with write access before running the program. 

Tb prevent damage to a directory, REORDR requires that all files in a UFD be 
closed during the entire operation. 
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NOTE 


REORDR verifies that no file is open when it starts to process the 
UFD. However, it is unable to detect file opening, creation, or deletion 
between the initial check and the completion of the UFD processing. 
REORDR can damage the file structure of a disk if a file creation takes 
place during reordering. For this reason, follow either of these steps as 
a precaution: 

• Disable logins with the SET SYSTEM/NOLOGINS command. Make 
sure that no other jobs (including spoolers and detached jobs) are 
active on the system. 

• Dismount the disk to be reordered and remount it using the 
/NOSHARE qualifier. 

The only safe way to reorder a UFD on the public structure is to disable 
logins and to make sure that no other user is currently logged in. You 
should reorder a UFD on a private disk only when you are sure that no 
other job will access the account(s) being reordered on that disk. If you 
follow the second step, this is no problem. 


11.2.4 Error and Processing Messages 


During the reordering of a UFD, the REORDR program holds the reordered UFD 
in a temporary file. At the conclusion of the ordering process, REORDR copies 
the temporary file back to the original UFD. As REORDR processes each UFD, it 
generates either a message indicating that the reorder worked or one that tells 
why an attempted reorder did not work. The messages REORDR prints in the 
attempt to reorder an account are: 


Directory dev:[m,n] 
Directory dev:[m,n] 
Directory dev:[m,n] 
Directory dev:[m,n] 
Directory dev:[m,n] 
Directory dev:[m,n] 
| <-format-> | 


cannot be Reordered 
does not exist 
has been Reordered 

is not Reordered - File filename.type is OPEN 
is not Reordered - No write access to UFD 
is Null 

| <-text-> I 


The general format and the example of the format contain a device designator 
and an account number: 


Directory 

Directory 


dev:[m, n] |<-text->| 

DR3:[1/223] has been Reordered 
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Table 11—3 explains each REORDER message and response. 

Table 11-3: REORDR Message and Response 

REORDR Message and Response 

cannot be Reordered 

Account [0,1] contains open files during timesharing and thus REORDR 
cannot reorder them. 

does not exist 

REORDR cannot find the account on the device. 

has been Reordered 

REORDR has successfully reordered the UFD. 
is not Reordered - File filename.typ is OPEN 

A user is accessing the UFD and thus REORDER leaves the UFD intact, 
is not Reordered - No write access to UFD 

REORDER encounters a UFD to which it cannot gain write access. It prints 
the error message and continues. 

is Null 

No UFD exists for the account. If REORDR encounters an account without 
a UFD, it prints the IS NULL error message. 


Fatal errors cause REORDR to print a message of the form: 

?REORDR Fatal Error [code] |<-message->| AT LINE nnnnnn 

All fatal REORDR errors include the 7REORDR Fatal Error prefix, a program 
error code, a message, and a program line number. Code represents the number 
of the program error that caused the fatal condition to occur. (Digital uses the 
code number to determine the reason for the fatal error.) REORDR prints a brief 
message to help identify the error. Finally, the error message includes the line 
number at which the program came to an end. Submit a Software Performance 
Report (SPR) to Digital whenever REORDR encounters a fatal error. 


11.2.5 REORDR Example 

The following example shows the REORDR dialogue and the messages that result 
from the reordering process: 

$ RUN AUXLIB$:REORDR 

REORDR V10.0-L RSTS V10.0-1 EDERE 

Sort Directory(s) (YES/NO) <NO>? YES 

Order by CRE[ATION], ACC[ESS] Date or FIL[ENAME] <CRE>? CREATION 
In FOR[WARD] or REV[ERSE] Order<FOR>? REVERSE 
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Device and UFD 
Directory DB1: 
Directory DB1: 
Directory DB1: 
Directory DB1: 
Directory DB2: 
Directory DB1: 
Directory DB2: 
Directory DB2: 
Directory DB1: 
Directory DB1: 
Directory DB1: 
Directory DB2: 
Directory DB2: 
Directory DB2: 
Directory DB2: 
Directory DB1: 
Directory DB2: 
Directory DB2: 
Directory DB2: 
Directory DB2: 
Directory DB2: 


Specification(s) ? DB1:[*,*],DB2: [*, *] 
[0,1] cannot be Reordered 
[1,1] cannot be Reordered 

[1.3] has been Reordered 

[1.4] has been Reordered 
[1,8] has been Reordered 

[1.13] has been Reordered 
[1,44] is Null 

[1,77] is Null 

[1.200] has been Reordered 

[1.201] has been Reordered 

[1.202] has been Reordered 
[2,227] has been Reordered 
[2,240] has been Reordered 
[26,12] has been Reordered 
[100,100] has been Reordered 
[120,50] has been Reordered 
[120,54] is Null 
[210,203] has been Reordered 
[232,15] has been Reordered 

[232.13] has been Reordered 
[251,0] has been Reordered 


Sort Directory(s) (YES/NO) <N0>? <^Z> 


11.3 Caching Control 

Data caching stores blocks from a user file for direct memory access. Directory 
caching stores the Master File Directory (MFD), the Group File Directory (GFD), 
the User File Directory (UFD), monitor overlay code, and other frequently 
accessed system files and directories. 

When a user job executes a read request, the RSTS/E monitor performs a disk 
access and transfers the requested block(s) of data and directory information from 
the disk to the user job’s buffer. With data and directory caching, the monitor 
stores the most recently read data blocks in an area of memory called the cache. 
If a user job executes a read request for either data or directory information in 
the cache, or both, the monitor copies the requested information directly from 
the cache into the job’s buffer. Because the system can thus retrieve data blocks 
from memory instead of disk, physical disk access is decreased. This can result in 
improved I/O throughput and faster response time. 

Data caching is only useful for read operations. Every write operation causes an 
actual write to the disk. In a write operation that modifies existing cached data, 
the data is updated, both in the cache and on the disk. 

Both data and directory caching are enabled during system installation. (See the 
RSTS/E System Installation and Update Guide.) 

You can disable and reenable data caching with the DCL command SET CACHE. 
Moreover, DCL commands let you specify caching for a particular file because it 
lets you mark the file’s UFD entry. 

Under the BASIC-PLUS or MACRO programming languages, you can use MODE 
values in the OPEN statement or monitor directives to open a file for cached data 
access. However, the use of caching MODE values and monitor directives requires 
TUNE privilege. As system manager, you can use the DCL command SET FILE 
(see Chapter 12) to designate a file for caching by marking its UFD entry. Once 
you mark a file’s UFD entry for caching, it is cached on OPEN regardless of the 
user’s privilege, as long as caching is enabled on the system. See the RSTS/E 
Programming Manual for information on the BASIC-PLUS OPEN statement and 
the RSTS/E System Directives Manual for information about MACRO directives. 
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When you enable data caching, the cache receives all data transfer requests that 
are otherwise directed to the disk driver. Read operations on data that is in the 
cache Occur without placing a load on the disk driver. The monitor constantly 
updates the cache so that it contains the most recently requested data for cached 
files. 


11-3.1 Size of the Cache 

The RSTS/E monitor allocates space for the cache from the Extended Buffer Pool 
(XBUF). You specify the amount of this allocation with DCL command qualifiers 
that set the size of a cache cluster (/CLUSTERSIZE=n) and the number of 
clusters in the cache (/MAXIMUM=n, /DIRECTORY_MAXIMUM=n, and /DATA__ 
MAXIMUM=n). The size of a cache cluster (1, 2, 4, or 8 blocks) determines the 
amount of data that is treated as a unit in a read request and, in many cases, 
the number of read requests that can be resolved in the cache before access to the 
disk driver is required. 

For example, when the cache cluster size is eight blocks, any read operation that 
installs data in the cache causes eight physically contiguous blocks (including the 
requested blocks) to be installed. To ensure that only requested data is read in to 
the cache, make the cache cluster size equal to or less than the pack cluster size 
(set during disk initialization) of the disk with the most files to be cached. 


11.3.2 Sequential and Random Caching Modes 

You can cache the data in a file in two ways: sequential or random. You can 
specify either of these modes for a particular file with the SET FILE command 
qualifiers (see Chapter 12). 

If a job executes a read operation on a cached file and the data is not in the 
cache, that data is installed in the cache if there is free space or if a current cache 
cluster is eligible for replacement. 

A cluster is eligible for replacement if either of the following conditions is in 
effect: 

• The last block of the cluster has been read in sequential mode. 

• The cluster has been in the cache without being read for more than the 
minimum residency time, which is set using the SET CACHE command. 


11.3.3 Random Mode Caching 

Digital recommends caching a file in random mode if the file is RMS index 
structured or a heavily overlaid program. With an RMS indexed file structure, 
the monitor does not access the data in the file sequentially but must check the 
file index each time it gets more data. Thus, it reads the index, the data, and the 
index again. 

As an example of random cache operation, consider a read operation executed 
on a file whose UFD entry is marked for random caching. When a read on the 
cached file occurs, the monitor examines the contents of the cache to determine if 
the requested data is present. If the data is in the cache, the data is copied from 
the cache cluster that contains it. The data is made available to the program and 
the cache cluster time of last access is updated. 


11-8 Device Management and Caching Control 








If the requested data is not in the cache, the monitor first attempts to allocate 
more of XBUF to install the new data (cache limits permitting). If XBUF cannot 
accommodate more data or the request exceeds the caching limits set with SET 
CACHE, then the monitor examines the list of cache clusters to find one that is 
eligible for replacement. If a cluster is not available, the monitor cannot install 
the requested data in the cache; a normal disk read is automatically performed. 
If the cache cluster is eligible for replacement, the monitor installs the requested 
data in that cache cluster and makes the data available to the program. 


11.3.4 Sequential Mode Caching 

Digital recommends caching a file in sequential mode if you access the contents of 
the file sequentially. As an example of sequential cache operation, consider a read 
operation executed on a file whose UFD entry is marked for sequential caching. 
When a read on the cached file occurs, the monitor examines the contents of the 
cache to determine if the requested data is present. If the data is in the cache, 
the data is copied from the cache cluster that contains it. The data is made 
available to the program. If, in the process, the last block of a cache cluster was 
read, that cluster is made available for replacement in the cache. 

Furthermore, when you request a read operation on any block of a cache cluster 
(except the last block), the monitor installs a full cluster of data in the cache. 
That is, if you use the SET CACHE command qualifier /CLUSTERSIZE=n to set 
a cache cluster size of 8 blocks and then execute a read on the first block of a file, 
the requested data plus the next 7 blocks from the disk are read into the cache. 
Thus, the contents of the next 7 reads can be satisfied from the cache. When the 
last block of the cache cluster is read, the cluster is immediately made available 
for the installation of new data as requested by other read operations. 

When a read operation from a sequentially cached file causes more than one 
cache cluster to be read, all of the requested data blocks are made available to 
the program. However, no data is installed in the cache for any cluster whose last 
block was read. (That is, only the last cluster can be installed and only if it was 
incompletely read.) If the cache cluster size is defined as one block and sequential 
mode is specified, no data blocks are installed in the cache. Thus, every data 
block is the last block in a cache cluster. 


11.4 Caching Guidelines 

The relationship between cache cluster size, which you set with a SET 
CACHE/CLUSTERSIZE=n command, and the pack cluster size of the file 
can have an effect on the efficiency of caching. The cache cluster size determines 
the number of blocks on a disk copied into the cache when a cluster is installed. 
If the cache and pack cluster sizes are equal, there is direct correspondence 
between the data that will probably be read and the data copied from the disk 
to the cache. If the cache cluster size is larger than the pack cluster size, the 
data you request plus some additional (and possibly unrelated) data is copied to 
the cache, wasting cache clusters. If the cache cluster size is less than the pack 
cluster size, a read request may require multiple disk accesses to move all of the 
data into several different cache clusters. 
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Figure 11—1 shows the flow of UFD entry and MODE value checks performed by 
the monitor. The result of these checks determines the type of caching to be used 
on the file. 

Figure 11-1: Caching Mode Checks 



The size relationship between the cache cluster and RMS indexed file bucket is 

similar to the size relationship between the cache cluster and the pack cluster. 

Efficient caching is obtained when the cache cluster and bucket sizes are equal 

because RMS always reads an entire bucket at once. 

Consider the following caching guidelines: 

• When setting defaults, the amount of XBUF you allocate to data and directory 
caching should be as large as possible while maintaining sufficient memory for 
user jobs, resident libraries, and run-time systems. However, an exceptionally 
large allocation can increase swapping activity, especially on systems with 
less than 256K words of memory. 

• On systems that use RMS heavily, consider the use of the RMS resident 
library and the library’s effect on XBUF allocation. Typically, on systems with 
less than 256K words of memory, the resident library should receive priority 
in memory allocation, to the extent of limiting XBUF allocation. In such a 
case, data caching may become ineffective and you probably should disable it. 

• To optimize directory caching, set all UFD cluster sizes to 16 blocks if possible. 

• Files that are frequently accessed sequentially (including RMS sequen¬ 
tial and relative files and heavily overlaid programs) should have their 
UFD entries marked for sequential caching with the DCL command SET 
FILE/CACHE=SEQUENTIAL. 


11-10 Device Management and Caching Control 


















• Files that are frequently accessed randomly (including RMS relative and 
indexed files) should have their UFD entries marked for random caching 
with the DCL command SET FILE/CACHE=RANDOM. Because of the way 
RSTS/E maintains RMS indexed files, they should always be flagged as 
random even if they are accessed sequentially Where possible, RMS indexed 
file bucket sizes should be a power of two to correspond with caching cluster 
sizes. 

• Use data caching judiciously on RMS indexed files. You gain the most benefit 
from caching an indexed file when it is subject to many read requests and is 
open for long periods of time. In addition, you should allocate more XBUF to 
compensate for the lower caching "hit" rate (the probability that the data you 
want to read is in the cache) on indexed file data. The hit rate is generally 
lower on indexed files than it is on sequential files or directory blocks. 

• Where possible, all files should be contiguous to reduce window turning. 

Where contiguous files are not possible, you should calculate the file cluster 
size as follows: 

1. Divide the file size by seven. 

2. Round the result to the next higher power of two (not greater than 256 
nor less than the pack cluster size). 

NOTE 

If you preextend the file and specify a cluster size of zero, RSTS/E 
does this calculation for you. 

• The minimum residency time is meant to keep some useful data in the cache, 
even when the cache is very small. Minimum residency time is also meant to 
make sure that if you want to access previously accessed data the system will 
find it in the cache, rather than having to read information off disk each time 
you request more. For systems with large caches or rapidly changing disk 
access patterns, it may be advantageous to reduce the minimum residency 
time from its default value of 60 seconds. Use the /KEEP=n qualifier to 
modify minimum residency time. 

Caching is not the most efficient data access method for all files under all circum¬ 
stances. But, in general, a high-access file is a logical candidate for caching. A 

high-access file meets one or more of the following conditions: 

• Accessed by more than one user at a time 

• Opened for long periods of time 

• Frequently accessed 

• Accessed sequentially (indexed files) 

• Primarily read 

• Is an overlaid program (such as a user program, TKB, or DTR) 

However, because of the large number of different applications, you must experi¬ 
ment to arrive at the best use of caching on your system. 
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11.5 Virtual Disks 


You can create a virtual disk that acts like a physical disk, only faster. 

A virtual disk is a reserved section of memory. Use the DCL commands 
CREATE/VIRTUAL_DISK and DELETE/VIRTUAL_DISK to create and delete 
the virtual disk. You must have the HWCFG and INSTAL privileges to use these 
commands. A system can have no more than one virtual disk. 

The virtual disk speeds up I/O, but uses more CPU time than standard disk 
I/O. Do not create a virtual disk on a system that is short of CPU time. Use the 
virtual disk when I/O is your principal bottleneck. 

You can create a virtual disk at any time, but it takes up a large amount of 
memory. Therefore, Digital strongly recommends that you create the virtual disk 
immediately after booting, before any libraries or auxiliary run-time systems get 
loaded. This minimizes the amount of time spent swapping things in and out of 
memory at the time of creation. 


11.6 DCL Command Descriptions 

The following sections describe the DCL commands and qualifiers for Device 
Management and Caching Control. 
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11.6.1 ALLOCATE Command 


This command allocates a device and optionally assigns it a logical name. 
ALLOCATE does not require any privileges to allocate a device to your own 
job. 


Format 

ALLOCATE dev: [logical-name[:]] 


Command Qualifiers Defaults 

/JOB=n none 

/[NOJQUEUED none 

/SEIZE none 


Prompts 

Device: 


Command Parameters 

dev: 

Specifies the device to be allocated. 

logical-name[:] 

Specifies the logical name to be assigned to the device. 

Command Qualifiers 

/JOB=n 

Allocates the device to the specified job. You need HWCTL privilege to use this 
qualifier. 

/[NOJQUEUED 

Temporarily sets or clears the queuing characteristic on the local LAT port you 
are allocating. This queued setting remains in effect until you deallocate the 
device. If /NOQUEUED is specified, the connection is not queued and if the 
remote port is busy, it fails. 

Use the SHOW PORT command to display the port’s connection status. If the 
port is set /QUEUED and the server is busy, a connection status of "In Progress" 
and the position in the queue are shown. 

If the qualifier is not specified, no change is made to the port’s queued setting. 

/SEIZE 

Reallocates a device currently allocated to another job. The /SEIZE switch 
returns an error message if a file is open on the device. You need HWCTL 
privilege to use this qualifier. 
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11.6.2 CREATE/VIRTUAL DISK Command 


This command reserves a section of memory for use as the virtual disk. Once 
the virtual disk has been created, you can initialize and mount it using the 
INITIALIZE and MOUNT commands. Use the SHOW MEMORY command to 
verify the location of the virtual disk after it has been created. Note that the 
virtual disk appears as locked out in the memory list until it has been initial¬ 
ized and mounted. CREATE/VIRTUAL_DISK requires INSTAL and HWCFG 
privileges. Example: 

$ CREATE/VIRTUAL_DISK 38 

Virtual Disk created with size of 40 blocks 
$ INITIALIZE/EXERCISE=0 DVO: V 
$ MOUNT DVO: V 
$ SHOW MEMORY 

Memory allocation table: 


Start 

End 

Length 

Permanent 

Temporary 

OK - 

99K 

( 

100K) 

MONITOR 


100K - 

102K 

( 

3K) 

MONITOR 


103K - 

426K 

( 

324K) 

(User) 


427K - 

436K 

( 

10K) 

Virtual Disk 

437K - 

4 4 6K 

( 

10K) 

(User) 

DAPRES LIB 

447K - 

4 50K 

( 

4K) 

(User) 

RMSRES LIB 

451K - 

511K 

( 

61K) 

** XBUF ** 


512K - 

*** end 

i *** 



$ SHOW 

DISK 






Disk Structure: 

Dsk Open Size Free Clu Err Name 

DVO 0 40 28 70% 1 0 V 

DU1 18 83204 47718 57% 2 0 RD32 


Level Comments 
1.2 Pri, DLW 

1.2 Pub, DLW 


Format 

CREATE/VIRTUAL_DISK disk-size 

Command Qualifiers Defaults 

/ADDRESS[=n] highest available memory 

/[NO]LOG /LOG 

Prompts 
Virtual disk size: 


Command Parameters 
disk-size 

Specifies the size, in blocks, of the virtual disk. If the disk size is not a multiple 
of 4, the system rounds it up to the next multiple of 4 blocks. A confirmation 
message tells you the actual size of the virtual disk. 
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Command Qualifiers 


/ADDRESS[=n] 

Specifies the address, in K-words, at which to locate the virtual disk. The address 
must be between 1 and 2043. Use the SHOW MEMORY command to select an 
available address to locate the virtual disk. The system returns an error message 
if the address is above the memory on the system, or if any part of the memory is 
in use. 

If you do not specify an address, the system puts the the virtual disk at the 
highest section of memory in which it will fit. The system returns an error 
message if there is not enough available memory to place the disk. 

/[NO]LOG 

Specifies whether or not you get a confirmation message saying the virtual disk 
was created. The confirmation message shows the actual size of the virtual disk. 
The default is /LOG. 
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11.6.3 DEALLOCATE Command 


This command deallocates the specified device. DEALLOCATE does not require 
any privileges. 


Format 

DEALLOCATE de v[:] 

Command Qualifiers Defaults 

/ALL none 

Prompts 

Device: 


Command Parameters 

dev: 

Specifies the device to be deallocated. 

Command Qualifiers 

/ALL 

Deallocates all devices that were allocated to the current job. 
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11.6.4 DELETE/VIRTUAL DISK Command 


This command frees up the section of memory reserved for the virtual disk. To 
delete the virtual disk, you must dismount it. It must not have files opened on 
it or an error will be returned. DELETE/VIRTUAL_DISK requires INSTAL and 
HWCFG privileges. Example: 

$ DELETE/VIRTUAL_DISK 
DELETE/VIRTUAL_DISK 

A 

?Virtual disk is mounted or has open files 
$ SHOW DISK 

Disk Structure: 

Dsk Open Size Free Clu Err Name 

DVO 0 40 28 70% 1 0 V 

DU1 18 83204 47718 57% 2 0 RD32 

$ DISMOUNT DVO: V 
$ DELETE/VIRTUAL_DISK 
Virtual disk deleted 


Level Comments 
1.2 Pri, DLW 

1.2 Pub, DLW 


Format 

DELETE/VIRTUAL_DISK 

Command Qualifiers Defaults 

/[NO] LOG /LOG 

Prompts 

none 


Command Qualifiers 
/[NO]LOG 

Specifies whether or not the system displays a confirmation message telling you 
the requested action was taken. The default is /LOG. 
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11.6.5 SET CACHE Command 


Lets you set caching parameters for the system as a whole. The SET CACHE 
command lets you enable data and directory caching on the system. Note 
that commands in the system startup command file normally enable caching 
automatically. SET CACHE requires TUNE privilege. 

When you use SET CACHE with no qualifiers, the last settings specified are 
applied. The initial system defaults are: 

/CLUSTERSIZE 4 blocks 

/MAXIMUM No limit on total cache allocation 

/DIRECTORY_MAXIMUM No limit on directoiy caching 

/DATA_MAXIMUM No limit on data caching 

/KEEP 60 seconds 

If you use SET CACHE/ALL, all read requests are cached. The type of caching 
(sequential or random) for a particular file is determined by the file’s UFD entry 
as specified in the SET FILE command or by an OPEN MODE specification. 
Digital recommends that you avoid using SET CACHE/ALL. It generally reduces 
performance except for a small number of specific applications. 

If you use SET CACHE/FILE, a file is cached on the basis of its UFD entry and/or 
the specified OPEN MODE. That is, a file is cached if either the UFD entry or 
OPEN MODE specifies caching; it is cached sequentially if either the UFD entry 
or OPEN MODE specifies sequential. 

If you use SET CACHE/NOFILE, RSTS/E does not cache files. This qualifier is 
used to enable directory caching but disable data caching on the system. 

Data and directories on a virtual disk (DV:) are never cached, since they are 
already in memory. 
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Figure 11-2 shows the mechanism by which the monitor decides the amount 
of caching to be performed. The figure shows the flow of DCL commands and 
caching specifications examined by the monitor. 

Figure 11-2: Monitor Caching Checks 



Use the SET CACHE/CLUSTERSIZE=n command to specify the cache cluster 
size as 1, 2, 4, or 8 blocks for each cluster. The cache cluster size controls the 
number of contiguous data blocks that are copied from disk to the cache whenever 
file data is cached. The cache cluster size should be small enough to contain only 
the target blocks but large enough to reduce the number of disk accesses. This 
means you must anticipate data requests and ensure that the cache cluster size 
is equal to the file cluster size of the files most frequently accessed. 

The SET CACHE/MAXIMUM=n command (where n is in the range 0 to 
UNLIMITED) specifies the total number of cache clusters used by both direc¬ 
tory and data caching. The default limit is UNLIMITED, which means that cache 
cluster allocation is limited only by the amount of XBUF available. 

The SET CACHE/DIRECTORY_MAXIMUM=n and 

SET CACHE/DATA_MAXIMUM=n commands (where n is in the range 0 to 
UNLIMITED) specify the cache cluster allocation for directory and data caching, 
respectively. The specified allocation is an upper limit. Thus, if a 40K-word 
XBUF is defined at system installation and /DIRECTORY__MAXIMUM and 
/DATA_MAXIMUM both specify a number of cache clusters equivalent to 25K, 
data can use space in the cache up to a maximum of 25K, which leaves a 15K 
minimum for directory caching. The reverse is also true. In this manner, data 
and directory caching are guaranteed a minimum allocation and the amount of 
overlap is controlled, which permits the cache to dynamically adjust to system 
and program requirements. 
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The SET CACHE/KEEP=n command specifies the cache replacement time in 
seconds. This is the amount of time that RSTS/E keeps an unused cache cluster 
in memory before the monitor makes it eligible for replacement by another cache 
cluster. 

The SET CACHE/DISABLE command disables all data and directory caching 
on the system. If you reenable caching following a disable and do not specify 
caching parameters (/CLUSTERSIZE, /MAXIMUM, /DIRECTORYJVIAXIMUM, 
/DATA_MAXIMUM, and /KEEP), the default parameters are those that were in 
effect before the disable. 


Format 


SET CACHE 

Defaults 
none 

/CLUSTERSIZE=4 
none 
none 
/ENABLE 
/ENABLE 
/FILE 
none 
none 

Prompts 

none 


Command Qualifiers 
/ALL 

/CLUSTERSIZE=n 

/DATA_MAXIMUM=n 

/DIRECTORY_MAXIMUM=n 

/DISABLE 

/ENABLE 

/[NO]FILE 

/KEEP=n 

/MAXIMUM=n 


Command Qualifiers 

/ALL 

Caches all data transfers. 

/CLUSTERSIZE=n 

Specifies a cache cluster size of n with values equal to 1, 2, 4, or 8 blocks The 
default is /CLUSTERSIZE=4. 

/DATA_MAXIMUM=n 

Specifies the maximum number of clusters (based on available memory) used for 
data caching in the range 0 to 65,535 or the keyword UNLIMITED. 

/DIRECTORY_MAXIMUM=n 

Specifies the maximum number of cache clusters used for directory caching in the 
range 0 to 65535 or the keyword UNLIMITED. 

/DISABLE 

Disables data and directory caching. The default is /ENABLE. 

/ENABLE 

Enables caching on the system using the previous settings as the defaults. The 
default is /ENABLE. 
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/[NO]FILE 

Indicates if file data should be cached. The /FILE qualifier indicates that file 
data is cached depending on their file attributes or OPEN MODE. The /NOFILE 
qualifier indicates that no file data is cached. The default is /FILE. 

/KEEP=n 

Specifies the cache replacement time in seconds that an unused cache cluster is 
kept in memory before the space can be used for another cache cluster. The value 
of n is in the range 0 to 65,535. 

/MAXIMUM=n 

Specifies the maximum number of cache clusters used for directory and data 
caching in the range 0 to 65,535 or the keyword UNLIMITED. 
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11.6.6 SET DEVICE Command 


This command sets the characteristics for the specified device. SET DEVICE 
requires HWCTL privilege to use /ENABLE, HWCFG to use /RESTRICT, HWCFG 
and HWCTL to use /DISABLE, and HWCFG and DEVICE to use /NORESTRICT. 


Format 

SET DEVICE dev[:] 


Command Qualifiers Defaults 

/DISABLE none 

/ENABLE none 

/[NOJRESTRICT none 


Prompts 

Device: 


Command Parameters 

dev[:] 

Specifies the device whose characteristics you want to change. 

Command Qualifiers 

/DISABLE 

Disables the specified device. No other qualifiers can be specified with /DISABLE. 

/ENABLE 

Enables a device that has been disabled by the SET DEVICE/DISABLE com¬ 
mand. 

/[NOJRESTRICT 

Tells the system which users can open or allocate the specified device. The 
/RESTRICT qualifier lets only users with DEVICE privilege open or allocate the 
device. The /NORESTRICT qualifier lets any user open or allocate the device. 
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11.6.7 SET PRINTER Command 

This command sets the characteristics of the specified line printer. SET 
PRINTER requires HWCFG privilege. 

Format 


SET PRINTER dev[:] 


Command Qualifiers 

Defaults 

/BACKSPACE[=mode] 

/BACKSPACE=REAL 

/[NOJCONTROLS 

none 

/[NO]CR_PREFIX 

none 

/DEVICE_TYPE=type 

none 

/[NO]EIGHT_BIT 

none 

/[NO]EOT 

none 

/[NOJFILL 

none 

/LOWERCASE 

none 

/[NO]OMIT_CR 

none 

/PAGE_LENGTH=n 

none 

/[NO]SPECIAL_CHARACTER[=char] 

none 

/[NOJTAB 

none 

/UPPERCASE 

none 

/WIDTH=n 

none 

Prompts 


Printer: 



Command Parameters 

dev[:] 

Specifies the line printer whose characteristics you want to set. 

Command Qualifiers 

/BACKSPACE[=mode] 

Tells the system how to handle backspace characters for this printer. The possible 
modes are: 

• CONTROL — Treats a backspace like other nonprinting characters. 

• REAL — Uses the actual backspace feature on the specified printer. 

• SIMULATE — Simulates the action of backspace on the specified printer by 
issuing a carriage return (CR) followed by the appropriate number of spaces 
to position the print head one column to the left of its original position. 

The default is /BACKSPACE=REAL. 
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/[NO]CONTROLS 

Tells the system how to handle nonprinting characters. /CONTROLS sends 
nonprinting characters to the line printer. /NOCONTROLS discards nonprinting 
characters or uses up arrow mode. 

/[NO]CR_PREFIX 

Tells the system how to handle line feed (LF), vertical tab (VT), and form feed 
(FF) characters. The options are: 

• /CR_PREFIX inserts a CR before a LF, a VT, or a FF. 

• /NOCR_PREFIX tells the printer to do an implied CR before a LF, a VT, or a 
FF. 

/DEVICE_TYPE=type 

Sets the characteristics of the line printer to the specified type: 

• LA180 — Sets the characteristics of the line printer to those of an LA180. 

• LN01 — Sets the characteristics of the line printer to those of an LN01. 

• LP11 — Sets the characteristics of the line printer to those of an LP11. 

When you use /DEV1CE_TYPE, you automatically set all the other printer 
characteristics as well. 

/[NO]EIGHT_BIT 

Tells the system how to handle 8-bit characters. The /EIGHT_BIT qualifier lets 
you send 8-bit characters to the line printer. The /NOEIGHT_BIT qualifier does 
not let you send 8-bit characters to the line printer. 

/[NO]EOT 

Tells the system how to handle an end-of-transmission character. The /EOT 
qualifier sends an end-of-transmission (Ctrl/D) to the line printer. The /NOEOT 
qualifier treats an end-of-transmission (Ctrl/D) like other nonprinting characters. 

/[NO]FILL 

Tells the system how to handle fill characters. The /FILL qualifier inserts fill 
characters after form feeds. The /NOFILL qualifier does not insert fill characters 
after form feeds. 

/LOWERCASE 

Sends lowercase characters to the line printer. 

/[NO]OMIT_CR 

Instructs the system on how you want the CR character handled. The /OMIT_ 
CR qualifier tells the system to omit the CR if the next character is a LF. The 
/NOOMIT_CR qualifier tells the system to always send CR to the printer. 

/PAGE_LENGTH=n 

Sets the form length of the line printer to n. The form length can be in the range 
1 to 255. 

/[NO]SPECIAL_CHARACTER[=char] 

Instructs the system on how you want the printer to handle its special character. 
The /SPECIAL_CHARACTER=char qualifier tells the printer to print its special 
character whenever it receives the specified char. Char can be given by its 
numeric value in the range 0 to 255 or by enclosing the character in quotation 
marks (") if it is printable. The /NOSPECIAL_CHARACTER qualifier tells the 
system to disable the special character feature for the specified line printer. 
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/[NO]TAB 

Instructs the system on how you want the TAB character handled. The /TAB 
qualifier indicates that the printer has hardware TAB capability The /NOTAB 
qualifier indicates that the printer does not have hardware TAB capability and 
the system has to translate TAB characters to the appropriate number of spaces. 


/UPPERCASE 

Tells the system to convert lowercase characters to uppercase before sending 
them to the line printer. 

/WIDTH=n 

Sets the width of the line printer to n. The width can be in the range 0 to 254. 
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11.6.8 SHOW CACHE Command 


This command displays the current caching parameters for your system. SHOW 
CACHE does not require any privileges. 

The listing includes information on cluster sizes, and data caching. For example: 

$ SHOW CACHE 
Caching configuration 

Caching enabled for Directories and Data 
Cache Keep timer = 60 seconds 
Cluster size = 4 

Data caching = File selectable 
XBUF usage (in K-words) 


Total cache: 

229.00 

(maximum 

clusters 

allowed: 

Unlimited) 

Directory cache: 

200.00 

(maximum 

clusters 

allowed: 

Unlimited) 

Data cache: 

29.00 

(maximum 

clusters 

allowed: 

Unlimited) 

ASSIGN/SYSTEM tables: 

0.94 





LOAD/OVERLAY tables: 

3.16 





LOAD/INDEX tables: 

9.22 





DCL Buffers: 

1.13 





Quota tables: 

0.38 

(small buffers in 

use: 0) 


Window turn blocks: 

0.00 

(maximum 

blocks used: 5) 



In this example, SHOW CACHE reports that: 

• Directory and data caching are currently enabled 

• The cache keep timer is set to 60 seconds 

• The cache cluster size is 4 blocks 

• Only selected files are cached 

• No limit is set on the use of XBUF for directory and data caching 

• 229 K words of XBUF are currently being used for directory and data caching 

• 200 K words of XBUF are currently being used for directory caching 

• 29 K words of XBUF are currently being used for data caching 

• 0.94 K words of XBUF are currently being used to store system logicals 
(ASSIGN/SYSTEM) 

• 3.16 K words of XBUF are currently being used to store monitor overlays 
(LOAD/OVERLAY) 

• 9.22 K words of XBUF are currently being used to store disk allocation 
indexes (LOAD/INDEX) 

• 1.13 K words of XBUF are currently being used for DCL buffers 

• 0.38 K words of XBUF are currently being used to store logged-in disk quota 
tables 

• No small buffers are being used to store logged-in disk quotas 

• No XBUF is currently being used for storing file window turn blocks 

• A maximum of 5 window turn blocks have been used since the system was 
started 
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Format 

SHOW CACHE 

Command Qualifiers Defaults 

/[NO]OUTPUT[=filespec] your terminal 

Prompts 

none 


Command Qualifiers 
/[NO]OUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 
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11.6.9 SHOW DEVICE Command 


This command displays information about the specified device. If you do not 
specify a device, RSTS/E displays information about all devices. SHOW DEVICE 
does not require any privileges. 


Format 

SHOW DEVICE [dev[:]] 

Defaults 
/ALL 
none 

your terminal 

Prompts 
none 


Command Qualifiers 
/ALL 

/ALLOCATED 

/[NO]OUTPUT[=filespec] 


Command Parameters 

dev[:] 

Specifies the device whose characteristics you want to display. 

Command Qualifiers 

/ALL 

Displays information about all devices configured on the system. A device 
specification overrides the /ALL qualifier. 

/ALLOCATED 

Displays information about all devices that are currently open or allocated. The 
display includes devices that are open as nonfilestructured devices. 

/[N0]0 UTPUT[=f i lespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 
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11.6.10 SHOW DISKS Command 


This command displays the status of all mounted disks. SHOW DISKS does not 
require any privileges. 


Format 

SHOW DISKS 

Command Qualifiers Defaults 

/[NO]OUTPUT[=filespec] your terminal 

Prompts 

none 


Command Qualifiers 
/[NO]OUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 
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11.6.11 SHOW PRINTER Command 


This command displays the characteristics of the specified printer. SHOW 
PRINTER does not require any privileges. 


Format 


SHOW PRINTER dev[:] 


Command Qualifiers 
/ALL 

/[NO]OUTPUT[=filespec] 


Defaults 

/ALL 

your terminal 


Prompts 

none 


Command Parameters 

dev[:] 

Specifies the printer whose characteristics you want to display. 

Command Qualifiers 

/ALL 

Displays information about all the printers configured on the system. A printer 
specification overrides the /ALL qualifier. 

/[NO]OUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 
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Chapter 12 

Managing System Files and Logical Names 


This chapter describes the DCL commands that you use to manage RSTS/E 
system files and logical names. Table 12-1 lists and briefly describes the 
DCL commands available to you. The rest of the chapter lists each command 
alphabetically and explains it in more detail. 


Table 12-1: DCL Commands for Managing System Files and Logical Names 


Command Meaning 

Run Time System Control 


INSTALL/RUNTIME_SYSTEM 
REMOVE/RUNTIME_SYSTEM 
SHOW RUNTIME_SYSTEM 
UNLOAD/RUNTIME_SYSTEM 


Adds the named run-time system to the list of installed 
run-time systems. 

Removes the name of a run-time system module as an 
entry in the run-time system table. 

Displays information about all installed run-time 
system. 

Unloads the named run-time system from memory. 


INSTALL/LIBRARY 

REMOVE/LIBRARY 
SHOW LIBRARY 
UNLOAD/LIBRARY 


Resident Library Control 

Adds the named library to the list of installed resident 
libraries. 

Removes the named file as a resident library. 

Displays information about all installed libraries. 
Removes the named resident library from memory. 



System Logical Names Control 

ASSIGN/SYSTEM 

Assigns a system-wide logical name to the specified de¬ 
vice type and unit. If you include an account number, 
the ASSIGN/SYSTEM command also associates that 
PPN with the logical name. 

DEASSIGN/SYSTEM 

Removes the entire entry for the logical name from 
the system logical table. It can also remove logical 
names for devices on your system. Device mnemonic 
names for system devices have permanent entries in 
the logical table. If you use the DEASSIGN/SYSTEM 
command to remove a logical name associated with a 
device, only the logical name goes away, not the device 
mnemonic. You can then assign a new name to that 
device. 


(continued on next page) 
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Table 12-1 (Cont.): DCL Commands for Managing System Files and Logical 
Names 


System Logical Names Control 

SHOW LOGICAL/SYSTEM 

Displays information about a system-wide logical 
name. 

System wide Command Language Control 

DEFINE/COMMAND/SYSTEM 

DELETE/COMMAND/SYSTEM 

SHOW COMMAND/SYSTEM 

Creates or redefines a system-wide command. 

Deletes the specified command from the list of defined 
system-wide commands. 

Displays information about the specified system-wide 
command. 

System File Control 

DUMP/SYSTEM 

INSTALL/ERROR_FILE 

INSTALL/OVERLAYJFILE 

INSTALL/SWAP_FILE=n 

REMOVE/ERROR_FILE 

REMOVE/OVERLAY_FILE 

REMOVE/SWAP_FILE=n 

SHOW FILE 

Records in the CRASH. SYS file the current state of the 
system so you or field service has a way to investigate 
reasons for system malfunctions. 

Installs the specified file as the system error message 
file. 

Installs the specified file as the system overlay file. 

Adds the specified file to the list of installed swap files. 
Valid values of swap-index are 0, 1, or 3. 

Removes the system error message file. 

Removes the system overlay file. 

Removes the specified swap file from the list of 
installed swap files. Valid values of swap-index are 0, 

1, or 3. 

Displays information about the specified file(s). 

User File Control 

SET FILE 

SHOW LOGICALS 

Sets the file characteristics. 

Displays information about a user-defined logical 
name. 


12.1 Run-Time System Control 

A run-time system on RSTS/E is the common, shareable part of a user job 
and, in some cases (for example, BASIC-PLUS), is the interface between the 
user s executable code and the monitor. Run-time systems control execution 
of jobs when the monitor allows the jobs to run. The monitor sets up jobs and 
establishes an environment in which a run-time system can function. The 
BASIC-PLUS run-time system interprets requests made by a user job, translates 
those requests into a format the monitor understands, and transmits the requests 
of the monitor. The monitor processes the requests and passes either data or an 
error to the job. The run-time system decides whether to interpret the data or 
log an error. Jobs running under the BASIC-PLUS run-time system cannot make 
direct requests to the monitor. 
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Other run-time systems may not be language interfaces in the same sense that 
the BASIC-PLUS run-time system is. Jobs under their control can make direct 
requests of the monitor. In such cases, the major role of the run-time system is to 
load compiled programs to handle system errors, and return control, on program 
termination, to the job’s keyboard monitor. Some of these run-time systems can 
also emulate the action of certain system directives from other operating systems, 
such as RT11. 

A run-time system interprets user requests when it is a language interface for a 
user job. A computer language provides a standard means by which many users 
can define data, process it, and obtain results. The language relieves each user of 
the need to learn the workings of the monitor. The run-time system under which 
the language operates is more efficient because multiple users can share the same 
code. This ability to share code is more efficient for the system because each user 
need not have a copy of the common code. 

All RSTS/E installations have DCL as the default keyboard monitor and can 
optionally have auxiliary run-time systems. DCL: 

• Allows users access to system resources 

• Interprets system command requests 

• Performs housekeeping chores 

An auxiliary run-time system: 

• Provides additional shared computer processing functions 

• Enables processing in other languages 

Such an auxiliary run-time system may compile and/or execute BASIC-PLUS-2, 
COBOL, DIBOL, FORTRAN-IV, FORTRAN-77, or other language operations. 

The system account [0,1] stores run-time systems as contiguous files with .RTS 
file types. You must store DCL on the system disk because, at the start of 
timesharing, the system disk is the only disk mounted on the system. You can 
store auxiliary run-time systems on any disk, either public or private. (Auxiliary 
run-time system files can also be stored in accounts other than [0,1].) All run¬ 
time system files are contiguous because they must be loaded into memory in the 
fastest time possible. 

Auxiliary run-time systems are created either during system installation or 
afterwards. The monitor structures that describe these run-time systems do not 
exist automatically at the start of timesharing. Therefore, you must provide the 
commands to add monitor structures for the auxiliary run-time systems that you 
want to make available for any given timesharing session. The structure for an 
auxiliary run-time system is dynamic and can be removed during a timesharing 
session. 

The DCL run-time system commands let you control operations of auxiliary 
run-time systems. The DCL commands perform additional processing for 
certain commands. To assist the system programmer, the command descriptions 
distinguish between the monitor call action and the DCL command action. 
Because run-time systems under development need certain special controls, 
some features of run-time system control are intended for Digital personnel only. 
Nevertheless, all features are described to give you a broader perspective. 

Digital recommends that you make auxiliary run-time systems available by 
commands in the START.COM file. By reading the descriptions in this section, 
you can understand what actions should occur for each run-time system 
command. 


Managing System Files and Logical Names 12-3 






12.1.1 Adding and Removing Auxiliary Run-Time Systems 

Because the structures that define auxiliary run-time systems are temporary, 
you must create them for each timesharing session. The INSTALL/RUNTIME_ 
SYSTEM command creates the necessary structure to enable an auxiliary run¬ 
time system to function. INSTALL/RUNTIME_SYSTEM command qualifiers can 
alter predefined characteristics of the run-time system. 

The INSTALL/RUNTIME_SYSTEM command creates a run-time system de¬ 
scription block with a general small buffer. A file with the name of the run-time 
system and a file type of .RTS can be in any account on the disk specified in the 
command. A run-time system with the same name cannot already exist on the 
system. The system makes sure that the file found is contiguous and has the 
proper format and parameters. 

You can specify qualifiers to override predefined characteristics. The 
INSTALL/RUNTIME_SYSTEM command extracts information from the run-time 
system file to establish the proper entries in the run-time system descrip¬ 
tion block. To establish the entries, the monitor opens the file, reads it, and 
sets up the predefined characteristics to be placed in the description block. 

You can change the predefined characteristics by the qualifiers: /PREFIX=n, 
/[NOJUNLOAD, /[NO]ERROR_LOGGING, /[NOJSHAREABLE, /[NO]READ 
ONLY, and /[NO]KEYBOARD_MONITOR. 

You can also change the predefined characteristics by negating these qualifiers. 
For example, if you were testing a run-time system with no special command 
decoding capabilities, you would use the qualifiers /NOSHAREABLE, /NOREAD_ 
ONLY, /NOERROR_LOGGING, and /UNLOAD to add the run-time system. The 
/NOSHAREABLE makes sure that no other job tries to share the untested code; 
/NOREAD_ONLY is necessary for setting breakpoints with the Online Debugging 
Tool (ODT); /NOERROR_LOGGING prevents false errors generated by the run¬ 
time system from cluttering the system error log; /UNLOAD makes sure that 
the run-time system’s image is not left in memory but is reloaded from disk 
immediately preceding every entry to it. 

The qualifiers and negations of the qualifiers do not alter the predefined char¬ 
acteristics in the run-time system file; only the characteristics defined in the 
description block are altered. The characteristics remain in effect until you 
remove the run-time system. 

The /[NO]ADDRESS[=n] qualifier lets you take advantage of high speed memory 
on the system or avoid fragmentation of memory. Without the /ADDRESS=n 
qualifier, the monitor decides where to load the run-time system each time 
residency is required. With the qualifier, the monitor loads the run-time system 
at the specific lK-word section of memory. You must include the /ADDRESS=n 
qualifier whenever you use the /NOREAD_ONLY qualifier. 

The /ADDRESS qualifier without an argument indicates that the monitor should 
compute a starting address by finding the highest memory segment large enough 
to hold the run-time system. 

The /NOADDRESS qualifier lets the run-time system "float" in memory; that is, 
RSTS/E computes a new address every time the run-time system is loaded into 
memory. The default is /NOADDRESS. 

Because lK-word section numbering begins at 0 and ends at n-1 (where n is 
the total size of memory), the IK section number in the /ADDRESS=n qualifier 
is one less than the physical section number. For example, to load the RT11 
run-time system (4K words in size) into the 61st through 64th IK sections of 
memory, specify /ADDRESS=60. The run-time system is loaded from low memory 
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to high memory at its defined initialized size. To be loaded without error, enough 
contiguous user space must be available starting at that location. 

The location specified in the /ADDRESS=n qualifier becomes the default location 
at which the run-time system is loaded during the current timesharing session. 
You need to change the location only if you exchange the allocation of the section 
of memory with either the DEFAULT or the START initialization options. 

One precaution is necessary when specifying the address at which the run-time 
system is loaded. The section of memory you choose must not fragment the user 
job space to prevent the run-time system from executing a job. For example, 
assume a system has 24K words of user space available between the 36K and 
60K sections of memory. Assume also that a job requires 18K words of user space 
to run and that the run-time system requires 4K words when resident. If the 
loading address is 36K, the space between 40K and 60K remains available for an 
18K job to run. If the loading address is 42K, the user space is fragmented into 
two sections — one from 36K to 42K and one from 46K to 60K. An 18K-word job 
area is not available to execute a job using this auxiliary run-time system. 

The system verifies that the memory section given in the /ADDRESS=n qualifier 
is reasonable. If the entire range of memory starting at the load address is not 
available, the system prints: 

?Memory not available 

You should consult a memory status report (for example, the report you get with 
the SHOW MEMORY command) to select an available range of memory. If the 
range of memory results in fragmenting that may cause a swapping violation, the 
system prints the error message: 

?Memory would be fragmented 

A swapping violation occurs if the memory to be occupied by the run-time system 
does not allow enough contiguous space for a maximum sized job to rim. 

Appendix D contains a summary of the errors that can occur when you are 
installing a run-time system. 

The /POSITION=n qualifier indicates the position in the linked list of blocks in 
which the run-time system block is to be placed. The default keyboard monitor 
block is always first in the list. If the run-time system you are adding is to be 
accessed frequently, you can reduce system overhead by placing it in the next 
position in the list. Without the qualifier, the system adds the block to the end of 
the list. 

If n in the /POSITION=n qualifier is one, the block is placed immediately after 
that of the default keyboard monitor. If n is zero or a value greater than the 
number of currently defined run-time systems, the block is added to the end of 
the list. The default is /POSITION=0. 

The position of a run-time system description block in the linked list affects how 
the system treats a RUN request for a file without a file type. On receiving such 
a RUN request, the system checks the indicated directory for all files with the 
specified name and an executable file type. 

For example, if the directory contained three files of the same name with file 
types .BAC, .TSK, and .SAV, the system checks for the run-time system nearest 
the default keyboard monitor in the linked list of description blocks. If RT11 was 
nearer than BASIC, the system runs the .SAV version of the file. 
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The /TYPE=filetype qualifier on the INSTALL/RUNTIMEJ3YSTEM command 
changes the default file type used for an executable file. If you do not specify this 
qualifier, the monitor extracts the file type defined in the run-time system file. 
The system applies this default file type when a user types a RUN command for 
a program and does not specify a file type. 

The /MINIMUM=s and /MAXIMUM=s qualifiers alter the minimum and maxi¬ 
mum job sizes (in K words) defined in the file for the run-time system. Generally, 
the minimum value allowed is one and the maximum is 32, the size of RTS, 
but a given run-time system may not allow this full range of job sizes. For 
BASIC-PLUS, the minimum and maximum sizes are 2 and 16, respectively. 

The /LOCK qualifier makes the run-time system permanently resident. Usually, 
an auxiliary run-time system is temporarily resident. It occupies memory as 
long as the currently active job is running under its control. The system frees 
the memory it occupies when that memory is needed to load another run-time 
system or to load a job running under another run-time system. (Thus, the 
run-time system may be nonresident if there are active jobs using it.) The system 
automatically loads the run-time system when a user needs it. If you specify the 
/LOCK qualifier, the auxiliary run-time system becomes permanently resident, as 
the default keyboard monitor is. The only way to make such a run-time system 
nonresident is to use the DCL command UNLOAD/RUNTIME_SYSTEM. 

The REMOVE/RUNTIME_SYSTEM command reverses the steps the 
INSTALL/RUNTIME_SYSTEM command performs. Before you can shut down 
the system, you must remove all auxiliary run-time systems. The SHUTUP pro¬ 
gram performs this removal operation automatically. The system checks to make 
sure that no jobs are currently running under control of the run-time system to 
be removed. If the usage count is zero, the description block is removed from the 
list and the run-time system file is closed. 

The UNLOAD/RUNTIME_SYSTEM command frees the memory occupied by the 
run-time system. If a job is currently resident or being loaded and intends to use 
the run-time system, the system prints: 

?Run-time system in use 


12.1.2 Associating a File with a Run-Time System 

The SET FILE/RUNTIME_SYSTEM=name command changes the name of the 
run-time system associated with a file. Every disk file on RSTS/E has in its 
directory the name of the run-time system under which it was created, except for 
files that are larger than 65,535 blocks. On a RUN request for the file, RSTS/E 
checks the name to find out what run-time system to use for the job. RSTS/E 

automatically passes control to that run-time system which, in turn, executes the 
file. 

To change the name, RSTS/E attempts to open the file to establish write access. 
If write access is denied, it prints: 

?Protection violation 

The name of the run-time system is written in the directory of the file speci¬ 
fied. RSTS/E performs this naming operation during the system library build 
procedures when a file designed to run under an auxiliary run-time system is 
transferred from the distribution medium. 
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12.2 Resident Library Control 


A resident library is a collection of shareable routines or data that the task 
builder links together into a task image file on disk. The MAKSIL program 
formats this disk file into Save Image Library (SIL) format. You can store 
resident libraries on any disk, either public or private. (Resident library files can 
be stored in accounts other than [0,1].) All resident library files are contiguous 
because they must be loaded into memory in the fastest time possible. See 
the RSTS/E Programmer's Utilities Manual for more information on resident 
libraries. 

You then use the INSTALL/LIBRARY command to assign the task image portion 
of the SIL file to a contiguous region of physical memory. Note that you can 
also use monitor SYS call -18 to assign the task image portion of the SIL file to 
memory. Once the body of shareable routines or data is linked, formatted, and 
assigned to memory, it becomes a resident library that is accessible to user tasks 
as part of their virtual address space. 


12.2.1 Resident Library DCL Commands 

You can use the DCL commands to install, remove, load, or unload a resident 

library. For example, the DCL command to add a resident library is: 

$ INSTALL/LIBRARY library-file-spec 

RSTS/E provides a flexible method for balancing library memory usage. As the 

number of resident libraries in use grows, two problems arise: 

• Smaller systems exhaust the available address space to assign to libraries 

• Swapping increases as jobs are continually moved in and out of the space 
assigned to libraries 

As a solution to these problems, resident libraries are divided into two classes: 

• Fixed address — specified either by the user or assigned by the monitor at 
the time of installation 

• Floating address — the load address is assigned by the monitor each time the 
library is loaded into memory 

The floating address class is further divided into two subclasses: 

• Restricted—the library and the program using it must be contained within 
the 32K words of virtual address space assigned to the job 

• Unrestricted — can occupy up to 255K words of virtual address space 

All floating address libraries must satisfy these conditions: 

• A job can be attached to only one floating address library at a time, but a job 
can attach to as many fixed address libraries as require, even if it is attached 
to a floating address library. 

• The program must be running under the RSX rim time system or its run time 
system must be installed at a fixed address. 
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• If a floating address library is installed either /LOCK or /NOREAD_ONLY, it 
becomes a fixed address library. 

• Floating libraries cannot be clustered. 

• Libraries of all types must be contiguous and have a file type of .LIB. 

You can install more floating libraries than the available physical memory allows. 
In this case, the libraries are stored on disk until they are needed, and then 
moved into memory, one at a time. However, only one library can be attached at 
a time. 

You use the LOAD/LIBRARY and its /ADDRESS qualifier to specify how you want 
to load a fixed address library and the /NOADDRESS qualifier to load a floating 
address library. In the following descriptions of these qualifiers, the equivalent 
UU.RTS starting address code is also given. 

When loading a fixed address library, you can assign the load address or let 
the monitor assign the address. To assign the address, specify /ADDRESS = n 
where n is the physical memory address, in K words, of the library base. The 
address space used by the library must not overlap other fixed address libraries 
or run time systems (UU.RTS address code = actual address). To let the monitor 
assign the load address, specify /ADDRESS. The monitor assigns the next highest 
available address for the library base so that there will be overlapping (UU.RTS 
address code = -1). 

When loading a floating address library, you can specify that it be either re¬ 
stricted or unrestricted. To load the library restricted, specify /NOADDRESS = 
UNRESTRICTED or /NOADDRESS. Libraries loaded in this way fit within the 
virtual address space of the attached program (UU.RST address code = 0). To 
load the library unrestricted, specify /NOADDRESS = UNRESTRICTED. The 
system ensures that the library does not overlap (UU.RST address code = -2). 

The /LOCK qualifier lets you make a resident library permanently resident. 
Usually, a resident library remains in memory only temporarily; that is, it 
occupies memory only as long as currently active jobs run under its control. 
However, when you need to access the library again, the system automatically 
reloads it. To force the library to remain permanently in memory, you must 
specify the /LOCK qualifier in the INSTALL/LIBRARY command. 

If you want to remove a resident library from memory, delete the monitor struc¬ 
ture that defines the library, and close the library file, use the DCL command: 

$ REMOVE/LIBRARY name 

Note that the REMOVE/LIBRARY command makes the resident library inacces¬ 
sible for sharing. However, the /UNLOAD qualifier, which can be used only with 
the INSTALL/LIBRARY command, only temporarily removes the library from 
memory while it is not in use. 

The UNLOAD/LIBRARY command removes a resident library from memory and 
thus frees memory that can then be used to load another library or be available 
for other system purposes. If you attempt to unload a resident library that is in 
the process of being loaded or is in use by the currently running job, the system 
prints the message: 

?Library in use 

Td prevent inadvertent loss of data, the monitor does not automatically unload a 
library you have loaded with the /NOREAD_ONLY qualifier. Unloading a library 
removes it from memory but does not write it back to disk. This means the 
system discards the library and retrieves a new copy from the disk when it is 
needed again. Thus, anything you write to a library that you mark read/write is 
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lost after you unload it with the UNLOAD/LIBRARY command. You must use 
the UNLOAD/LIBRARY command to unload a resident library that is designated 
read/write. 

Whether a library remains in memory depends on the qualifiers you attach to 
the INSTALL/LIBRARY command. The /LOCK and /NOREAD_ONLY qualifiers 
prevent the monitor from removing it automatically. In addition, the monitor 
does not remove a library to which a user job is attached; instead, the system 
prints: 

?Library in use 


12.3 System Logical Names 

RSTS/E lets users access devices by logical names as well as by physical names. 
Logical names that apply to all users are called system logical names. On all 
systems, users can refer to a disk by its pack identification or by a name that 
replaces the pack identification. Thus, each disk unit configured on RSTS/E 
systems has the capability of being accessed by a system logical name. Logical 
names that apply to a single job are called user logical names. 

You can define system logical names for nondisk devices and additional names for 
disk devices. The number of names is limited by the size of XBUF. Such a system 
logical name can have an account number associated with it. Consequently, use 
of the name refers not only to the related device but also to the account on the 
device. The system treats device names in the following manner: 

1. Checks the list of user logical names first. (If the logical name has a $ 
character in it, this step is omitted.) 

2. Scans the table of disk logical names for a matching pack identification or 
equivalent. 

3. Checks the additional names. 

4. Checks the list of valid physical device names. 

If individual users have not defined user logical names that duplicate currently 
defined system logical names, all users have access to devices by the logical 
names the system manager adds. 

A system logical name must be unique. A pack identification or its logical 
name cannot conflict with any other pack identification or system logical name. 
However, you can define multiple system logical names for the same device. 

If the pack identification (or a logical name to replace the pack identification) of 
a disk you are to mount is the same as an existing system logical name, then 
RSTS/E mounts the disk with no system logical name. Unless you specify a 
different, unique name, the disk, at mount time, has no logical name associated 
with the device and unit being used. 

System logical names apply for a single timesharing session; however, you can 
remove or change them during the session. Digital recommends that you place 
the proper commands in START.COM to define names automatically at system 
startup time. See the RSTS/E Programming Manual for more details on system 
logical names. 


Managing System Files and Logical Names 12-9 







12.3.1 Assigning Logical Names 

The ASSIGN/SYSTEM dev:[PPN] logical-name command defines a system 
logical name for nondisk devices or an additional name for a disk device. You 
need INSTAL privilege to use ASSIGN/SYSTEM. If the name duplicates one 
currently defined and you specify the /REPLACE=QUERY qualifier or you omit 
the /[NO]REPLACE qualifier, DCL prints a warning message and prompts to see 
if you want to replace the logical. If you specify /NOREPLACE and the logical 
name is already defined, DCL prints the error message: 

?Logical already installed 

To change a currently defined name, use the ASSIGN/SYSTEM/REPLACE 
command. 

The logical name can contain from 1 to 15 alphabetic or numeric characters. 

You can include the dollar sign ($) character; however, it must not be the first 
character. You can also include the underscore character (__). If the name contains 
illegal characters, DCL points to the first nonalphanumeric character by printing 
one of the following error messages: 

?Invalid logical name 
?Unexpected character 

If there is no more room in XBUF, the system prints: 

?No buffer space available 

The device with which the name is associated must exist on the system. If it does 
not, the system prints: 

?Not a valid device 

The ASSIGN/USER dev:[PPN] logical-name command defines a user logical 
name for nondisk devices or an additional name for a disk device. If the name 
duplicates one that is currently defined and you specify the /REPLACE=QUERY 
qualifier, DCL prints a warning message and prompts to see if you want to 
replace the logical. If you specify /NOREPLACE and the logical name is already 
defined, DCL prints the error message: 

?Logical already installed 

If you omit the /[NOJREPLACE qualifier, the logical is replaced and DCL prints 
the message: 

Logical name replaced 

The logical name can contain from 1 to 15 alphabetic or numeric characters. You 
cannot include the dollar sign ($) character; this character is only allowed in 
system logicals. You can also include the underscore character (J, but it cannot 
be the first character. If the name contains illegal characters, DCL points to the 
first nonalphanumeric character by printing one of the following error messages: 

?Invalid logical name 
?Unexpected character 

If there is no more room in XBUF, the system prints: 

?No buffer space available 

The device with which the name is associated must exist on the system. If it does 
not, the system prints: 

?Not a valid device 
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12.3.2 Removing Logical Names 

The DEASSIGN/SYSTEM command deletes the association defined for the 
specified logical name. You need INSTAL privilege to use DEASSIGN/SYSTEM. 
Because a system logical name must be unique, you need to specify only the name 
in the command. If the name you include is not currently defined, the system 
prints: 

?Logical not found 

If you use an illegally formed name, the system points to the first nonalphanu- 
meric character by printing one of the following: 

?Invalid logical name 
?Unexpected character 

lb delete all logical names for a device, you must use the DEASSIGN/SYSTEM 
command for each currently defined name. 

The DEASSIGN/USER command deletes the association defined for the specified 
logical name. Because a user logical name must be unique, you need to specify 
only the name in the command. If the name you include is not currently defined, 
the system prints: 

?Logical not found 

If you use an illegally formed name, the system points to the first nonalphanu- 
meric character by printing one of the following: 

?Invalid logical name 
?Unexpected character 

lb delete all logical names for a device, you must use the DEASSIGN/USER 
command for each currently defined name. 


12.3.3 Listing System Logical Names 

The SHOW LOGICALS displays, for the specified logical name, the device 
designation and unit number, any account number associated with the logical 
name, and the logical name itself. If you do not specify a logical name, RSTS/E 
lists all systemwide and user-defined logical names. If you specify the first few 
characters of a system logical name, followed by an asterisk (*), RSTS/E lists all 
the names beginning with those letters. RSTS/E displays the entries in the order 
in which they are found in the monitor tables. 


12.4 Defining Concise Command Language Commands 

Concise Command Language (CCL) commands on RSTS/E lets users type system- 
level commands that load and run programs from disk. To take advantage of 
this feature, you must code your programs to recognize a CCL entry and to 
extract any command string passed to them. The RSTS/E Programming Manual 
describes the operation and interpretation of CCL commands. 

Certain RSTS/E programs can interpret a standard set of CCL commands. A 
RSTS/E installation can have any number of unique CCL commands. You make 
all CCL commands available to users by the DEFINE/COMMAND/SYSTEM 
command which creates the monitor structure required. You need INSTAL 
privilege to use the DEFINE/COMMAND/SYSTEM command. 
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Because the monitor structure that defines a CCL command is temporary, 

CCL commands must be defined at the start of each timesharing session. It is 
suggested that you place the proper command definitions in START.COM. 

Each CCL command definition occupies one small buffer on the system. All 
definitions are in a linked list of small buffers. The system executes a SYS call 
to add or remove CCL definitions and provides a way to list all currently defined 
CCL commands. 


12.4.1 Adding a CCL Definition 

To add SY-STAT as a CCL command, execute the DEFINE/COMMAND/SYSTEM 
command as follows: 

$ DEFINE/COMMAND/SYSTEM SY-STAT [1,2]SYSTAT.* 

This command adds the definition for the SYSTAT system program. The hyphen 
(-) designates the abbreviation point so typing SY runs the SYSTAT program. If 
you do not include a hyphen in your CCL definition, the system places a hyphen 
at the end of the command and allows no abbreviation. RSTS/E assumes the 
public disk structure (SY:) when you do not specify a device. Programs you run 
with a CCL command can reside on any disk device, but if it is not in the public 
structure, you must include the device in the command definition. The account 
designation [1,2] in the example means SYSTAT must reside in the system 
library. If you do not specify an account with the CCL command, the system 
assumes the program is located in the account in which the job (that is, the job of 
the user later invoking the CCL) is running. 

The asterisk (*) in SYSTAT.* indicates a wildcard file type. In the case of multiple 
versions of SYSTAT, the version of SYSTAT that is run depends on the order of 
the run-time systems in your run-time system list. 

You can specify the line number at which execution starts by appending the 
/LINE_NUMBER=n qualifier to the command. The value of n can be any integer 
from 0 to 32767. There are standard entry points that you can specify by the use 
of keywords: 

• CCL — 30,000 

• DCL — 30,500 

• CHAIN —31,000 

The system performs error checking before adding the CCL command. If the 
command is invalid, RSTS/E points to the first nonalphanumeric character by 
printing one of the following error messages: 

?Invalid command 
TUnexpected character 

pointing to the first nonalphanumeric character. A valid command can consist of: 

• A string of 1 to 9 alphanumeric characters 

• The first character must be a letter, or one of the following single characters: 
@ or # 
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Lowercase letters are equivalent to uppercase in the definition and use of CCL 
commands. The $ CCL is reserved; it always points to DCL. The command can 
have a maximum of nine characters. If more than nine characters are present, 
the system prints: 

?Command too long 

When you add two or more commands that begin with the same character or 
set of characters, you must define the command with the largest number of 
characters (to the left of the hyphen) first. You then define the command with 
the next fewest characters to the left of the hyphen, until you have made all the 
assignments. For example, you must define MACR-O before adding MAC-, or 
RSTS/E prints: 

?Command not unique 

This message also appears if you attempt to define a command that was already 
defined. 

If you need to add a longer CCL definition after you have already added a similar 
but shorter one, you must first remove the shorter entry. You then add the longer 
CCL command which lets you reinstall the CCL with the shorter command name. 
For example, if you had installed MAC- and at some later date needed to add 
MACR-O, you would have to remove MAC-, install MACR-O, and then reinstall 
MAC-. The section "Removing a CCL Definition" describes how to remove CCL 
entries. 


12.4.2 Listing Currently Defined CCL Commands 

The SHOW COMMAND/SYSTEM command prints a listing of all currently 
defined CCL commands. You can also list a single CCL command with the 
SHOW/COMMAND/SYSTEM <name> command. You need INSTAL privilege to 
see the program name and characteristics in the SHOW COMMAND/SYSTEM 
command. The list of CCL commands on your system may include: 


$ SHOW COMMAND/SYSTEM 


ATT-ACH 

= 

SY: [ 

1,2 

]LOGIN 

. * 

/LINE=CCL 

/PRIVILEGE 

BYE- 

= 

SY: [ 

1,2 

]LOGOUT 

. * 

/LINE=0 

/PRIVILEGE 

DIR-ECTORY 

= 

SY: [ 

1,2 

]DIRECT 

m * 

/LINE=CCL 

/PRIVILEGE 

DIS-MOUNT 

= 

SY: [ 

1,2 

]UMOUNT 

. * 

/LINE=CCL 

/PRIVILEGE 

EDT- 

= 

SY: [ 

1,2 

] EDT 

.TSK 

/LINE=0 


HELL-0 

= 

SY: [ 

1,2 

]LOGIN 

. * 

/LINE=0 

/PRIVILEGE 

HE-LP 

= 

SY: [ 

1,2 

] HELP 

. * 

/LINE=CCL 

/PRIVILEGE 

LBR- 

= 

SY: [ 

1,2 

] LBR 

.TSK 

/LINE=0 


LIBR- 

= 

SY: [ 

1,2 

] LIBR 

.SAV 

/LINE=8208 


LIN-K 

= 

SY: [ 

1,2 

] LINK 

.SAV 

/LINE=8208 


MACR-O 

= 

SY: [ 

1,2 

]MACRO 

.SAV 

/LINE=8216 


MAC- 

= 

SY: [ 

1,2 

] MAC 

.TSK 

/LINE=0 


MOU-NT 

= 

SY: [ 

1,2 

]UMOUNT 

. * 

/LINE=CCL 

/PRIVILEGE 

PIP- 

= 

SY: [ 

1,2 

]PIP 

.SAV 

/LINE=8208 


PL-EASE 

= 

SY: [ 

1,2 

]PLEASE 

. * 

/LINE=CCL 

/PRIVILEGE 

QU-EUE 

= 

SY: [ 

1,2 

] QUE 

. * 

/LINE=CCL 

/PRIVILEGE 

SUB-MIT 

= 

SY: [ 

1,2 

] QUE 

. * 

/LINE=CCL 

/PRIVILEGE 

SY-STAT 

= 

SY: [ 

1,2 

]SYSTAT 

. * 

/LINE=CCL 

/PRIVILEGE 

TE-CO 

= 

SY: [ 

1,2 

] TECO 

.TEC 

/LINE=3584 


TKB- 

= 

SY: [ 

1,2 

] TKB 

.TSK 

/LINE=0 



$ 
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The system prints the commands in the order in which they were defined. If no 
CCL commands are currently defined, the system prints the message: 

%No Commands installed 


NOTE 

When you start the system, the monitor automatically installs the $ 
CCL. You cannot redefine the $ CCL. 

The $ CCL lets you issue DCL commands from any command environ¬ 
ment. For example, from BASIC-PLUS you can type: 

Ready 

$ MOUNT DLO:MINDY/NOSHARE <RET> 

Ready 


12.4,3 Removing a CCL Definition 

To remove a CCL definition, type the command DELETE/COMMAND/SYSTEM 
followed by the definition. You need INSTAL privilege to execute the 
DELETE/COMMAND/SYSTEM command. You can type either a full definition or 
a valid abbreviation to indicate the command you plan to remove: 

$ DELETE/COMMAND/SYSTEM MYPR-OG 

If the definition does not currently exist, the system prints: 

?Command not found 

If the definition exists, the command removes the CCL definition immediately. 
You can delete all the CCL commands by appending the /ALL qualifier to the 
DELETE/COMMAND/SYSTEM command. For example: 

$ DELETE/COMMAND/SYSTEM/ALL 


12.5 System File Control 

You allocate and position the following system files on file-structured disks 
by executing the INSTALL/SWAP_FILE, INSTALL/OVERLAY_FILE, or 
INSTALL/ERRORJFILE commands: 

• SWAPO.SYS 

• SWAP1.SYS 

• SWAP3.SYS 

• OVR.SYS 

• ERR.SYS 

These optional files optimize system performance by taking advantage of higher 
speed disks and the characteristics of user jobs running on the system. Because 
the files are contiguous and contiguous space becomes scarce as user files are 
created during timesharing, preallocation and prepositioning are necessary. The 
RSTS/E Installation and Update Guide describes the planning considerations for 
preallocating and positioning these system files. 
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RSTS/E does not automatically access these system files. You control RSTS/E 
access to these files with DCL commands. Thus, the use of these files during 
timesharing is dynamic. If a hardware problem occurs on a swap device, you can 
remove the device without stopping timesharing. To maintain the same amount 
of swap space, you can designate a private disk as the swap device. 

This section discusses the DCL commands that control system file usage. The 
commands in the startup control file allow access to system files at the start of 
timesharing operations. 


12.5.1 Adding and Removing Swap Files 

The swap files SWAPO.SYS, SWAP1.SYS and SWAP3.SYS in account [0,1] 
are standardized names for the three optional swap files. While these names 
are optional, Digital recommends you use them because they indicate the 
characteristics of the files. You can, however, assign any file name to these three 
swap files. The system restricts the file type to .SYS regardless of the file names 
you include in the DCL commands. 

The INSTALL/SWAPJFILE command causes the system to access a specific file (if 
a file-structured device is involved) or a specific device (if a nonfile-structured disk 
is involved). You need INSTAL privilege to execute the INSTALL/SWAPJFILE 
command. A typical command sequence is: 

$ INSTALL/SWAP_FILE=0 DR3:SWAP0 
$ INSTALL/SWAP_FILE=1 DRlsSWAPl 
$ INSTALL/SWAP FILE=3 DR4:SWAP3 


NOTE 

When you specify a nonfile-structured device in the INSTALL/SWAP_ 

FILE command, the monitor destroys any existing file structure on that 
device. 

The /SIZE=n qualifier of the INSTALL/SWAPJFILE command allows creation of 
a swap file during timesharing. The qualifier is most useful when you want to 
add a swap file to a private disk that contains sufficient contiguous space for the 
file. The value n in the /SIZE=n qualifier represents the number of blocks in the 
file. RSTS/E attempts to access the file with a file type of .SYS in account [0,1] on 
the associated device. If the file already exists and the file size differs from the 
size specified in the /SIZE=n qualifier, RSTS/E prints a warning message in the 
format: 

%Swap file name already exists at size x blocks 
The value x is the actual size of the swap file. 

If the file does not exist, the system attempts to create a contiguous file of the 
size specified. If there is not enough contiguous space available to create the file, 
the system prints: 

?Not enough contiguous space to create Swap file 

If the system creates the swap file, the file is marked NOBACKUP. During a 
backup operation, the swap file attributes are backed up, but not the data. 

The /POSITION=n qualifier lets you place the created swap file in a particular 
location on the specified disk. The monitor ignores this qualifier if it already 
exists. 
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After you type the INSTALL/SWAP_FILE command, the system tries to install 
the particular file or device as the swap file. If the system finds any errors, 
RSTS/E prints an error message. Appendix D contains a list of the possible 
errors. If no errors occur, the system installs the swap file. 

You can then activate the added swap file with the SET SYSTEM/LOGINS 
command. The SET SYSTEM/LOGINS command forces the system to examine 
all swap file space and to calculate the number of jobs the system is capable of 
running. 

During timesharing, the number of jobs that can run on the system depends on: 

• The job maximum (JOB MAX) set at system generation 

• The amount of swap space added 

• The number of logins allowed through the SET SYSTEM/LOGINS command 

At the start of timesharing, the number of logins allowed is one. One job is 
necessary for the DCL START.COM file to rim. You can increase this number 
by using the SET SYSTEM/LOGINS command, but the number is restricted 
by the swap space available and by JOB MAX. When you add swap space with 
INSTALL/SWAP_FILE commands, the capacity to handle logins is increased. 

The SET SYSTEM/LOGINS command sets the number of logins to the maximum 
allowed. This maximum cannot exceed JOB MAX. 

RSTS/E lets you dynamically remove as well as add swap files 0, 1, and 3. To 
remove a swap file or device, first decrease the number of logins using the SET 
SYSTEM/NOLOGINS or SET SYSTEM/LOGINS n command. The number of 
logins to be decreased depends on the capacity of the swap file to be removed. 

By decreasing the number of logins, you allow the system to safely remove swap 
space. 

The sequence of commands to remove a swap file is the reverse of the sequence 
to add swap space. For example, assume that a system is running with a JOB 
MAX of 63 and is using a swap file with a capacity of 16 jobs. In this case, you 
must decrease the number of logins by 16 jobs before removing the swapfile. The 
following sequence shows this procedure: 

$ SET SYSTEM/LOGINS 47 
$ REMOVE/SWAP_FILE=1 
$ 

In practice, it may take some time for the system to adjust operations. If the 
number of jobs currently running is greater than 47 or if the number of logins 
allowed is too large, the system prints the error message: 

?Too many logins allowed to remove Swap file 

You must wait until users log out of the system. The SHOW BUFFERS command 
or the DISPLY program prints the number of jobs currently on the system in the 
free buffer status report. (The SHUTUP program automatically removes swap 
files.) 

It is possible to add more swap space than the system can use. In this case, you 
do not need to reduce logins to remove a swap file. However, enough room must 
remain to swap all jobs currently logged in, or to swap all jobs that can log in, 
whichever is greater. 
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The SHOW FILE/SYSTEM command provides a way for you to verify that the 
following files exist on your system: 

• Swap files (/SWAP_FILE) 

• Overlay file (/OVERLAY_FILE) 

• Error file (/ERROR_FILE) 

• DECnet/E Network Services Protocol (NSP) system file (/NETWORK.FILE) 


This command is most useful when you want to verify the addition or re¬ 
moval of any of these files. After adding a file, you can use the SHOW 
FILE/SYSTEM/SWAP_FILE command to verify, for example, that you gave 
the file the correct file specification, or that the file was added properly. 

If you add a swap file, such as DR3:[0,1]SWAP0.SYS, execute the SHOW 
FILE/SYSTEM/SWAP_FILE command as follows: 


$ SHOW FILE/SYSTEM/SWAP FILE 


Swapfile 
Swapfile 

0: 

Is 

DR3 : 

None 

[0, 1 ] SWAP0 

.SYS 

10240 

blks 

Swapfile 

2: 

DR1: 

[0, 1] SWAP 

.SYS 

256 

blks 

Swapfile 

3: 

DR4 : 

[0, 1]SWAP3 

.SYS 

1000 

blks 


(40 jobs at 66K Swap max) 

(1 job at 66K Swap max) 

(3 jobs at 66K Swap max) 


$ 


RSTS/E prints None beside the files that do not exist. Note that the system 
cannot add or remove the DECnet/E file but can only verify that the file exists 
on your system. There is no DCL command to add or remove this file. Refer to 
the SET SYSTEM and CLEAR SYSTEM commands in the DECnet/E System 
Manager's Guide for further information. 


12.5.2 Adding and Removing Overlay and Error Files 

You can add and remove the overlay and error message files during timesharing. 
OVR and ERR are standardized names to denote the separate file for the overlay 
code and the alternate file for the default error message file. Although you can 
use other file names, Digital recommends that you keep the standardized ones. 
Regardless of the names you give the files, the system requires you to use a file 
type of .SYS. You need INSTAL privilege to use the INSTALL command. 

The INSTALL/OVERLAY_FILE command directs the system to use the specified 
file for the system overlay code. Similarly, the INSTALL/ERROR_FILE command 
causes the system to use the specified file when it reads error messages. To add 
these system files, specify the commands as in the following example: 

$ INS TALL/0VERL A Y_FILE DU2:OVR 
$ INS TALL/ERROR_FILE DBO:ERR 

For the overlay file, the system copies the overlay code from the monitor SIL to 
the file OVR.SYS on DU unit 2. For the error message file, the system copies into 
ERR.SYS on DB unit 0 the contents of the error message file (ERR.ERR). You 
must make sure that the disk on which an overlay or error file resides is mounted 
when you issue this command. As with swap files, you can use the /SIZE and 
/POSITION qualifiers for overlay and error files. If the system creates these files, 
they are marked NOBACKUP. During a backup operation, the file attributes are 
backed up, but not the data. 
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To install these files, the system makes sure that the files exist and are properly 
formed. If the system finds any errors, it prints an error message. 

Appendix D contains the text of all error messages. If no errors occur, the system 
has successfully added the file and is accessing it. You do not need to enter any 
further commands. 

You can remove these files at any time with the REMOVE/OVERLAY_FILE and 
REMOVE/ERROR_FILE commands. Then the system accesses the original data. 
Note that the SHUTUP program automatically removes both files. 


12.5.3 Using the DUMP/SYSTEM Command 

The DUMP/SYSTEM command lets you take an online dump of the current 
monitor image executing in memory. When you execute the DUMP/SYSTEM 
command, RSTS/E copies the memory to the crash dump file CRASH.SYS in 
account [0,1]. You need SYSIO privilege to use the DUMP/SYSTEM command. 
Use the DUMP/SYSTEM command as follows: 

$ DUMP/SYSTEM 

Once the copy operation is complete, you can use the ANALYS program to analyze 
the contents of the file (see Chapter 10). 

The system returns the following error message if crash dump was not enabled: 

?Can't find file or account 

This can happen only if sufficient disk space was not available at system startup 
to allocate the CRASH.SYS file. To correct this condition, free up the necessary 
amount of disk space, shut down and then restart the system. 

If a user who does not have SYSIO privilege attempts to dump memory with 
DUMP/SYSTEM, the system prints: 

?SYSIO privilege required 

Use of the DUMP/SYSTEM command may also return various device dependent 
errors. For example: 

?Device hung or write locked 


12.6 DCL Command Descriptions 

The following sections describe the DCL commands for managing system files and 
logical names. 
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12.6.1 ASSIGN/SYSTEM Command 


This command assigns a systemwide logical name to the specified device type 
and unit. If you include an account number, the ASSIGN/SYSTEM com¬ 
mand also associates that project-programmer number with the logical name. 
ASSIGN/SYSTEM requires INSTAL privilege. 


Format 

ASSIGN/SYSTEM dev: [p,pn] name[:] 

Command Qualifiers Defaults 

/[NO]REPLACE[=QUERY] /REPLACE=QUERY 

Prompts 

Device: 

Logical name: 


Command Parameters 

dev: 

Specifies the device type and unit to which you want to assign a systemwide 
logical name. 

[p,pn] 

The optional PPN to which you want to assign a systemwide logical name. DCL 
does not allow any spaces between the device specification and the PPN. 

name[:] 

The name that you want added to the system logical name table. The name can 
include up to 15 alphanumeric characters, including the dollar sign ($). 

Command Qualifiers 

/[NO]REPLACE[=QUERY] 

Determines what action to take if the logical name already exists. /REPLACE 
means replace the logical if it already exists. RSTS/E displays an informational 
message. /NOREPLACE means display an error message and do not replace 
the logical if it already exists. If neither is specified or if /REPLACE=QUERY is 
specified, RSTS/E displays a warning message and prompts to see if you want to 
replace the logical. 
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12.6.2 DEASSIGN/SYSTEM Command 


This command removes a specified logical name from the system logical table. 

It can also remove logical names for devices on your system. Device mnemonic 
names for system devices have permanent entries in the logical table. So, if you 
use the DEASSIGN/SYSTEM command to remove a logical name associated with 
a device, only the logical name goes away, not the device mnemonic. You can then 
give a new name to that device. DEASSIGN/SYSTEM requires INSTAL privilege. 


Format 

DEASSIGN/SYSTEM name[:] 

Command Qualifiers 
none 

Prompts 
Logical name: 


Command Parameters 

name[:] 

Specifies the logical name to be removed from the system logical table. 
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12.6.3 DEFINE/COMMAND/SYSTEM Command 


This command creates or redefines a systemwide command (CCL). 
DEFINE/COMMAND/SYSTEM requires INSTAL privilege. 


Format 

DEFINE/COMMAND/SYSTEM command-name filespec 


Command Qualifiers 
/LI N E_N U M BE R=entry-point 
/[NOIPRIVILEGE 
/[NO]REPI_ACE[=QUERY] 


Defaults 

none 

none 

NOREPLACE 


Prompts 
Command: 
Program name: 


Command Parameters 

command-name 

Specifies the command you want to define. 

filespec 

Specifies the file you want to associate with the command. 

Command Qualifiers 

/LINE_NUMBER=entry-point 

Defines the entry point in the command program as follows: 

• n — Defines the entry point as the specified integer in the range 0 to 32,767 

• CCL — Defines the entry point as the CCL entry point (30,000) 

• CHAIN — Defines the entry point as the CHAIN entry point (31,000) 

• DCL — Defines the entry point as the DCL entry point (30,500) 

/[NO]PRIVILEGE 

Specifies whether the program needs to retain its temporary privileges (see 
Chapter 6). 

/[NO]REPLACE[=QUERY] 

Specifies what action the system takes if the specified system command is 
already defined. If you specify /REPLACE, the system replaces the specified 
command with the new definition. If you specify /NOREPLACE and the specified 
command is already defined, you receive an error message. If you specify 
/REPLACE=QUERY and the specified command is already defined, the system 
prompts you and asks if you want to replace the definition. The default is 
/NOREPLACE. 
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12.6.4 DELETE/COMMAND/SYSTEM Command 


This command deletes the specified command from the list of defined systemwide 
commands (CCLs). DELETE/COMMAND/SYSTEM requires INSTAL privilege. 


Format 

DELETE/COMMAND/SYSTEM command 

Command Qualifiers Defaults 

/ALL none 

Prompts 

Command: 


Command Parameters 
command 

Specifies the command to be deleted from the list of defined systemwide com¬ 
mands. 

Command Qualifiers 

/ALL 

Deletes all systemwide commands. 
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12.6.5 DUMP/SYSTEM Command 



This command records in the CRASH.SYS file the current state of the system 
so you or field service has a way to investigate reasons for system malfunctions. 
DUMP/SYSTEM requires SYSIO privilege. 

Format 

DUMP/SYSTEM 

Command Qualifiers 

none 

Prompts 

none 
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12.6.6 INSTALL/ERROR_FILE Command 

This command installs the specified file as the system error message file. 
INSTALL/ERROR_FILE requires INSTAL privilege. 

Format 


INSTALL/ERROR_FILE 

[filespec] 

Command Qualifiers 

Defaults 

/[NO] LOG 

/LOG 

/POSITION=position 

none 

/SIZE=n 

none 

Prompts 


Error file: 



Command Parameters 
[filespec] 

Specifies the file to be installed as the system error message file. If you do not 
specify a file name, the system uses the default file _SY:[0,1]ERR.SYS. 

Command Qualifiers 
/[NO]LOG 

Indicates whether the system displays a confirmation message after it installs the 
error file. The default is /LOG. 

/POSITION=position 

Places the error file at the specified position on the disk. You must also specify 
the /SIZE=n qualifier. The value of position can be one of the following: 


Value 

Meaning 

position 

Locate the file at the first available position on the device past the 
specified Device Cluster Number. 

INDEX 

Locate the file at the first available position past the Master file 
Directory (MFD) index. 

MIDDLE 

Locate the file at the first available position past the middle of the 
device. 


/SIZE=n 

Creates a system file with a size of n blocks. The /SIZE=n qualifier is required 
if the file does not already exist. If the system creates the file, it is marked 
NOBACKUP. During backup operations, the file attributes are backed up, but not 
the data. 
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12.6.7 INSTALL/LIBRARY Command 


This command adds the named library to the list of installed resident libraries. 
INSTALL/LIBRARY requires INSTAL privilege. 


Format 

INSTALL/LIBRARY library-name 

Defaults 

See discussion 
See discussion 
/ERROR_LOGGING 
/NOLOCK 
/PROTECTION=42 
/READONLY 
/SHAREABLE 
/NOUNLOAD 

Prompts 
Library: 


Command Qualifiers 
/[NO]ADDRESS[=n] 
/[NO]ADDRESS=[UN]RESTRICTED 
/[NO]ERROR_LOGGING 
/[NOJLOCK 
/PROTECTION^ 
/[NO]READ_ONLY 
/[NO]SHAREABLE 
/[NOJUNLOAD 


Command Parameters 

library-name 

Specifies the name of the library to add to the list of installed resident libraries. 

Command Qualifiers 

/[NO]ADDRESS[=n] 

Indicates that the resident library should be loaded into memory in lK-word 
sections beginning at address n. Specifies the address in memory to load the 
resident library. Values can be in the range IK to 2043K. 

If n is omitted, RSTS/E computes the starting address by finding the highest 
memory segment large enough to hold the named library. If this qualifier is 
omitted, RSTS/E computes a new starting address each time it loads the named 
library into memory. 

/[NO]ADDRESS=[UN]RESTRICTED 

Allows installation of size-restricted or unrestricted floating libraries. 

/[NO]ERROR_LOGGING 

Indicates whether errors that occur within the resident library should be recorded 
in the system error log. The /ERROR_LOGGING qualifier logs any errors that 
occur in the resident library to the system error log. The /NOERROR_LOGGING 
qualifier prevents errors that occur within the resident library from being 
recorded in the system error log. The default is /ERROR_LOGGING. 
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/[NO]LOCK 

Indicates whether the resident library should remain in memory. The /LOCK 
qualifier locks the resident library in memory. The /NOLOCK qualifier unlocks 
the resident library from memory. The default is /NOLOCK. 

/PROTECTION=n 

Sets the protection code of the resident library. The default code is 42. 

/[NO]READ_ONLY 

Indicates the allowable type of access to the resident library. The /READ_ONLY 
qualifier allows read-only access to the resident library. The /NOREAD__ONLY 
qualifier allows the resident library to be mapped read/write. The default is 
/READ-ONLY. 

/[NO]SHAREABLE 

Indicates how many users can access the resident library simultaneously. The 
/SHAREABLE qualifier lets more than one user access this resident library at the 
same time. The /NOSHAREABLE qualifier lets only one user access the resident 
library at any time. The default is /SHAREABLE. 

/[NOJUNLOAD 

Indicates whether the resident library should remain in memory when no jobs 
are using it. The /UNLOAD qualifier removes the resident library from memory 
whenever there are no jobs using it. The /NOUNLOAD qualifier keeps the 
resident library in memory even when there are no jobs using it. The default is 
/NOUNLOAD. 
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12.6.8 INSTALL/OVERLAY FILE Command 


This command installs the specified file as the system overlay file. 
INSTALL/OVERLAY_FILE requires INSTAL privilege. 


Format 

INSTALL/OVERLAY_FILE [filespec] 


Command Qualifiers Defaults 

/[NO] LOG /LOG 

/POSITION=position none 

/SIZE=n none 


Prompts 
Overlay file: 


Command Parameters 
[filespec] 

Specifies the file to be installed as the system overlay file. If you do not specify a 
file name, the system uses the default file, J3Y:[0,1]OVR.SYS. 

Command Qualifiers 
/[ NOJLOG 

Indicates whether the system displays a confirmation message after it installs the 
overlay file. The default is /LOG. 

/POSITION=position 

Places the overlay file at the specified position on the disk. The /SIZE=n qualifier 
is required. The value of position can be one of the following: 


Value Meaning 

position Locate the file at the first available position on the device past the 

specified Device Cluster Number. 

INDEX Locate the file at the first available position past the Master file 

Directory (MFD) index. 

MIDDLE Locate the file at the first available position past the middle of the 

device. 


/SIZE=n 

Creates a system file with a size of n blocks. This qualifier is required if the file 
does not already exist. If the system creates the file, it is marked NOBACKUP. 
During backup operations, the file attributes are backed up, but not the data. 
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12.6.9 INSTALL/RUNTIMESYSTEM Command 

This command adds the named run-time system to the list of installed run-time 
systems. INSTALL/RUNTIME_SYSTEM requires INSTAL privilege. 

Format 


INSTALL/RUNTIMESYSTEM name 

Command Qualifiers 

Defaults 

/[NO]ADDRESS[=n] 

See discussion 

/[NO]ERROR_LOGGING 

/ERROR_LOGGING 

/[NO]KEYBOARD_MONITOR 

/NOKEYBOARD_MONITOR 

/[NO]LOCK 

/NOLOCK 

/MAXIMUM_SIZE=n 

none 

/MINIMUM_SIZE=n 

none 

/POSITIONS 

at end of list 

/PREFIX[=n] 

/PREFIX=255 

/[NO]READ_ONLY 

/READONLY 

/[NOJSHAREABLE 

/SHAREABLE 

/TYPE=filetype 

See discussion 

/[NOJUNLOAD 

/NOUNLOAD 

Prompts 


Run-time system: 



Command Parameters 

name 

Specifies the name of the run-time system to be added to the list of installed 
run-time systems. 

Command Qualifiers 

/[NO]ADDRESS[=n] 

Specifies the address in memory to load the run-time system. The value of n 
can be in the range IK to 2043K. If n is omitted, RSTS/E computes the starting 
address by finding the highest memory segment large enough to hold the run¬ 
time system. If the qualifier is omitted, RSTS/E computes a new starting address 
each time it loads the run-time system into memory. 

/[NO]ERROR_LOGGING 

Indicates whether the run-time system should log errors occurring under its 
control to the system error file. The /ERROR_LOGGING qualifier indicates that 
this rim-time system should log errors. The /NOERROR_LOGGING qualifier 
indicates that it should not log errors. The default is /ERROR_LOGGING. 
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/[NO]KEYBOARD_MONITOR 

Indicates whether the run-time system has a keyboard monitor. The 
/KEYBOARD_MONITOR qualifier indicates that this run-time system 
is a keyboard monitor. The /NOKEYBOARD.MONITOR qualifier indi¬ 
cates that this run-time system is not a keyboard monitor. The default is 
/N OKEYBOARD_MONITOR. 


/[NOJLOCK 

Indicates whether the run-time system should reside permanently in memory. 
The /LOCK qualifier indicates that the run-time system should reside perma- 
- n «y m memory. The /NOLOCK qualifier indicates that the run-time system 
should not reside permanently in memory. The default is /NOLOCK. 

/MAXIMUM_SIZE=n 

Uses n K words as the maximum job size. 

/MINIMUM_SIZE=n 

Uses n K words as the minimum size job allowed. 

/POSITIONS 

Places the run-time system block in the nth position after the default keyboard 
monitor in the linked list. By default, RSTS/E positions the run-time system at 
the end of the list. N can be any number in the range from 0 to 255. 

/PREFIX[=n] 

Causes the run-time system to use the RSTS/E special prefix EMT feature. The 
value n can be any number from 0 to 255. RSTS/E selects the code 255 by default 
if you do not specify a value for n. 

/[NO]READ_ONLY 

Indicates whether the run-time system should allow read-only memory ac¬ 
cess. The /READ_ONLY qualifier indicates read-only memory access. The 
/NOREAD_ONLY qualifier indicates read/write memory access. The default is 
/READ_ONLY. 


/[NOJSHAREABLE 

Indicates whether the run-time system supports multiple users. The 
/SHAREABLE qualifier indicates that the run-time system supports more than 
one user at the same time. The /NOSHAREABLE qualifier indicates that the 
run-time system supports only one job at a time. The default is /SHAREABLE. 

/TYPE=filetype 

Specifies the default file type for files executed under the run-time system. By 
default, DCL uses the file type defined in the run-time system file. 

/[NOJUNLOAD 

Specifies whether RSTS/E unloads the run-time system from memory when 
no one is using it. The /UNLOAD qualifier removes the run-time system from 
memory when all users are using another run-time system or when no jobs 
are using the run-time system. The /NOUNLOAD qualifier keeps the run-time 
system in memory even when no jobs are using it. The default is /NOUNLOAD. 
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12.6.10 INSTALL/SWAP_FILE Command 

This command adds the specified file to the list of installed swap files. Valid 
values of swap-index are 0, 1, or 3. INSTALL/SWAP_FILE requires INSTAL 
privilege. 

Format 


INSTALL/SWAPFILE 

[=]index [filespec] 

Command Qualifiers 

Defaults 

/DEVICE=disk-name[:] 

none 

/[NO] LOG 

/LOG 

/POSITION=position 

none 

/SIZE=n 

none 

Prompts 


Swapfile number: 


Swapfile name: 



Command Parameters 

index 

Specifies the index of the specified file. Valid values are 0, 1, and 3. If you do not 
enter a filespec, the system uses the default file, J3Y:[0,l]SWAPn.SYS, where n is 
the index number. 

filespec 

Specifies the file to add to the list of installed swap files. You must specify the 
disk. 

Command Qualifiers 

/DEVICE=disk-name[:] 

Specifies a disk to be used as a swapping device. RSTS/E uses this disk as a 
non-file-structured device. Note that any data on the disk is lost. 

If you include the /DEVICE qualifier, you cannot include a file-spec parameter or 
include the /SIZE or /POSITION qualifiers. 

/[NO]LOG 

Indicates whether the system displays a confirmation message after it installs the 
swap file. The default is /LOG. 


12-30 Managing System Files and Logical Names 











/POSITION=position 

Places the created system file at the specified position on the disk. You must also 
specify the /SIZE=n qualifier. The value of position can be one of the following: 


Value 

Meaning 

position 

Locate the file at the first available position on the device past the 
specified Device Cluster Number. 

INDEX 

Locate the file at the first available position past the Master file 
Directory (MFD) index. 

MIDDLE 

Locate the file at the first available position past the middle of the 
device. 


/SIZE=n 

Creates a system file with a size of n blocks. The /SIZE=n qualifier is required 
if the file does not already exist. If the system creates the file, it is marked 
NOBACKUP. During backup operations, the file attributes are backed up, but not 
the data. 
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12.6.11 REMOVE/ERROR FILE Command 


This command removes the system error message file. REMOVE/ERROR_FILE 
requires INSTAL privilege. 


Format 

REMOVE/ERROR_FILE 

Command Qualifiers Defaults 

/[NOJLOG /LOG 

Prompts 

none 


Command Qualifiers 

/[NOJLOG 

Indicates whether the file specification of the removed file is displayed at the 
terminal. If the file specification contains any wildcards, the default is /LOG. 
Otherwise, the default is /NOLOG. 
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12,6.12 REMOVE/LIBRARY Command 


This command removes the named file as a resident library. REMOVE/LIBRARY 
requires INSTAL privilege. 


Format 

REMOVE/LIBRARY library-name 

Command Qualifiers 
none 

Prompts 

Library: 


Command Parameters 
library-name 

Specifies the file to remove from the list of resident libraries. 
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12.6.13 REMOVE/OVERLAY_FILE Command 



This command removes the system overlay file. REMOVE/OVERT ,AV_FTT .F. 
requires INSTAL privilege. 

Format 

REMOVE/OVERLAY_FILE 

Command Qualifiers 

none 

Prompts 

none 
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12.6.14 REMOVE/RUNTIME_SYSTEM Command 


This command removes the named run-time system as an entry in the run-time 
system table. REMOVE/RUNTIME_SYSTEM requires INSTAL privilege. 


Format 

REMOVE/RUNTIME_SYSTEM name 

Command Qualifiers 
none 

Prompts 
Run-time system: 


Command Parameters 
name 

Specifies the name of the run-time system to remove from the list of installed 
run-time systems. 
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12.6.15 REMOVE/SWAP FILE Command 


This command removes the specified swap file from the list of installed swap 
files. Valid values of swap-index are 0, 1, or 3. REMOVE/SWAP_FILE requires 
INSTAL privilege. 


Format 

R EMOV E/SWA P_FI L E [=]index 

Command Qualifiers Defaults 

[NO] LOG LOG 

Prompts 
Swapfile number: 


Command Parameters 

index 

Specifies the index of the swap file to remove. Valid values are 0, 1, or 3. 

Command Qualifiers 

/[NOJLOG 

Indicates whether the system displays a confirmation message after it removes 
the swap file. The default is /LOG. 
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12.6.16 

SET FILE Command 

This command changes the characteristics of the specified file(s). SET FILE 
requires read and write access to the file(s). 

Format 

SET FILE filespec 

Command Qualifiers 

Defaults 


/[NOJBACKUP 

None 


/[NO]CACHE[=mode] 

none 


/NOCONTIGUOUS 

None 


/[NOJDELETABLE 

None 


/[NO]IGNORE 

None 


/[NOJLOG 

/NOLOG 


/[NOJPLACED 

None 


/PROTECTION^ 

None 


/RUNTIME_SYSTEM=name 

None 


Prompts 

Files: 



Command Parameters 

filespec 

Specifies the file whose characteristics you want to change. You can use wildcard 
characters in the file specification. 

Command Qualifiers 

/[ NOJBACKUP 

The backup qualifier specifies whether or not the contents of the file are backed 
up during a backup operation. The attributes of the file are backed up, regardless 
of the qualifier you specify. 

/[NO]CACHE[=mode] 

The /CACHE qualifier specifies that the file is automatically cached when open. 
The type of caching depends on the file’s UFD entry and the specified OPEN 
MODE. If you use /CACHE alone on a file with no UFD setting or MODE 
specification, the default is random caching. This qualifier requires TUNE 
privilege. The optional arguments are: 

• SEQUENTIAL — Causes RSTS/E to mark the file’s UFD entry such that, if 
the file is cached, it is cached sequentially. 

• RANDOM — Causes RSTS/E to mark the file’s UFD entry so, if the file is 
cached, it is cached randomly. Note that you can override the random cache 
UFD setting with a sequential caching MODE specification. 
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The /NOCACHE qualifier specifies that the file is not automatically cached when 
open. To cache such a file, you must specify SET CACHE/ALL or specify a MODE 
value (see the RSTS/E Programming Manual). 

/NOCONTIGUOUS 

Lets you extend a contiguous file by changing it to noncontiguous. 

/[NO]DELETABLE 

Indicates whether a file can be deleted or renamed during timesharing. In a 
directory listing, RSTS/E shows NODELETABLE files with the flag P (protected) 
after their size. This qualifier requires SYSIO privilege. 

/[NOJIGNORE 

Indicates whether or not the file is ignored for all backup operations. 

/[NOJLOG 

Indicates whether the file specification of each modified file is displayed at the 
terminal. If the file specification contains any wildcards, the default is /LOG. 
Otherwise, the default is /NOLOG. 

/[NO]PLACED 

Indicates whether, after modification, a file is placed at its present position on the 
disk. 

/PROTECTIONS 

Sets the protection code of a file. The protection code must be in the range 0 to 
255. You can also use the SET PROTECTION command to perform this function. 
This qualifier requires SYSIO privilege to set the privilege bit of the protection 
code. 

/RUNTIME_SYSTEM = name 

Associates a run-time system with the file. The name can be any valid run-time 
system name from the SHOW RUNTIME_SYSTEM display. When the system 
tries to execute this file, it uses the named run-time system to load the executable 
file. This qualifier requires SYSIO privilege for file(s) whose protection code is 
192 or higher. 
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12.6.17 SHOW COMMAND/SYSTEM Command 


This command displays information about the specified systemwide command. 
SHOW COMMAND/SYSTEM requires INSTAL privilege for a full listing. 
Without INSTAL privilege, SHOW COMMAND/SYSTEM only displays the 
command you name. 


Format 

SHOW COMMAND/SYSTEM [command-name] 

Command Qualifiers Defaults 

/ALL /ALL 

/[NO]OUTPUT[=filespec] your terminal 

Prompts 

none 


Command Parameters 
[command-name] 

Specifies the systemwide command whose information you want displayed. If 
you do not include this parameter, RSTS/E displays all system commands. If you 
specify the first few letters of a command, RSTS/E displays all the commands 
beginning with those letters. 

Command Qualifiers 

/ALL 

Displays information about all the systemwide commands. This is the default. 

/[NO]OUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 
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12.6.18 SHOW FILE/SYSTEM Command 


This command displays information about the specified system file(s). 
SHOW/FILE/SYSTEM does not require any privilege. 


Format 


SHOW FILE/SYSTEM 

Command Qualifiers 
/ALL 

/ERROR_FILE 

/NETWORK_FILE 

/[NO]OUTPUT[=filespec] 

/OVERLAY_FILE 

/SWAP_FILE[=n] 

Prompts 

none 


Defaults 

/ALL 

/ALL 

/ALL 

your terminal 
/ALL 

all swap files 


Command Qualifiers 

/ALL 

Displays information about all installed files. The default is / ATI. 

/ERRORFILE 

Displays information about the system error message file. 

/NETWORK_FILE 

Displays information about the network database file. 

/[NO]OUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 

/OVERLAY_FILE 

Displays information about the system overlay file. 

/SWAP_FILE[=n] 

Displays information about the specified swap file, where n is 0, 1, or 3. If no 
argument is given, RSTS/E lists all swap files. 
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12.6.19 SHOW LIBRARY Command 


This command displays information about all installed libraries. SHOW 
LIBRARY does not require any privilege. 

The following is an example of the SHOW LIBRARY display: 


$ SHOW LIBRARY 
Resident Libraries: 


Name 

Prot 


Acct 

Size 

Users 

Comments) 

HISTOG 

< 

42> 


i 

1,2 ] 

3 6K 

0 

Perm, 

Addr:1628 

CSPLIB 

< 

42> 

DR1 

t 

0,1 ] 

8K 

8 

Temp, 

Addr:117 

RMSRES 

< 

42> 

DR1 

t 

0,10 ] 

4K 

1 

Temp, 

Addr:1624 

RMSLBB 

< 

42> 

DR1 

t 

0,10 ] 

3K 

1 

Temp, 

Addr:1621 

RMSLBA 

< 

42> 

DR1 

[ 

0,10 ] 

4K 

0 

Temp, 

Addr:1617 

RMSLBD 

< 

42> 

DR1 

[ 

0,10 ] 

2K 

0 

Temp, 

Addr:1615 

RMSLBC 

< 

42> 

DR1 

[ 

o 

1-* 

o 

2K 

0 

Non-Res, Addr:1613 

RMSLBE 

< 

42> 

DR1 

i 

0,10 ] 

3K 

0 

Temp, 

Addr:1610 

RMSLBF 

< 

42> 

DR1 

t 

0,10 ] 

4K 

0 

Temp, 

Addr:1606 

DAPRES 

< 

42> 

DR1 

t 

0,10 ] 

10K 

0 

Temp, 

Addr:876 

EDT 

< 

42> 

DR1 

t 

0,11 ] 

38K 

1 

Temp, 

Addr:15 6 8 

B2MRES 

< 

42> 

DR1 

i 

0,1 ] 

19K 

0 

Temp, 

Addr:830 


$ 


Format 

SHOW LIBRARY 

Command Qualifiers Defaults 

/[NO]OUTPUT[=filespec] your terminal 

Prompts 

none 


Command Qualifiers 

/[NO]OUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 
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12.6.20 SHOW LOGICALS Command 


This command displays information about all the currently assigned systemwide 
and user-defined logical names. SHOW LOGICALS does not require any privi¬ 
lege. 


Format 


SHOW LOGICALS [logical-name] 


Command Qualifiers Defaults 


/ALL 

/[NO]OUTPUT[=filespec] 

/SYSTEM 

/USER 


/ALL 

Your terminal 

/ALL 

/ALL 


Prompts 

None 


Command Parameters 

[logical-name] 

Specifies the logical name whose information you want displayed. You can specify 
the standard RSTS/E wildcards * and ? to display all logical names that match 
the specified pattern. If you do not specify wildcards, only those user or system 
logical names that exactly match the specified sogical name. 

By default, this command displays system and user logical names. 

Command Qualifiers 

/ALL 

Displays information about all systemwide and user-defined logical names. /ALL 
is the default. 

/[NO]OUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 

/SYSTEM 

Displays all systemwide logical names. 

/USER 

Displays your currently assigned logical names. 
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Examples 



l. 


$ SHOW LOGICAL 
User Logicals: 

LB =DU13:[1,1] 

SYSTEM =DU2: [232,101] 


System Logicals: 

LB =SY:[1,1] 

HELP$ =SY:[0,2] 

WPS$ =SY:[0,78] 

This command displays all user and system logical names. 


2 . 


$ SHOW LOGICAL/USER 

User Logicals: 

LB =DU13:[1,1] 

SYSTEM =DU2: [232,101] 

This command displays all user logicals. 

$ SHOW LOGICAL LB 
User Logical: 

LB =DU13:[1,1] 

System Logical: 

LB =SY:[1,1] 

This command displays user and system logical names LB. 

$ SHOW LOGICAL/USER LB 


User Logical: 

LB =DU13:[1,1] 

This command displays the user logical name LB. 
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12.6.21 SHOW RUNTIME SYSTEM Command 


This command displays information about all installed run-time systems. SHOW 
RUNTIMEJ3YSTEM does not require any privilege. The following is an example 
of the display: 

$ SHOW RUNTIME_SYSTEM 
Run-Time Systems: 


Name 

Ext 

Dev 

Size 

Users 

Comments 



-..RSX 

TSK 


0 (64)K 

14 

Monitor, KBM 



DCL 

COM 

DR1 

28 (4) K 

8 

Temp, 

Addr:7 7, 

DF KBM 

RT11 

SAV 

DR1 

4 (28)K 

0 

Temp, 

Addr:109, 

KBM, 

CSZ, EMT:255 

TECO 

TEC 

DR1 

10 (20)K 

0 

Temp, 

Addr:383, 

KBM 


BAS4AL 

BAC 

DR1 

17(12)K 

0 

Non-Res, KBM, CSZ 


BAS4F 

BAC 

DR1 

16(16)K 

0 

Temp, 

Addr:322, 

KBM, 

CSZ 

BASIC 

BAC 

DR1 

15(16)K 

1 

Temp, 

Addr:133, 

KBM, 

CSZ 

FORTH 

4TH 

DR1 

6 (24) K 

0 

Temp, 

Addr:125, 

KBM, 

NER, CSZ 

GMBODT 

COM 

DRO 

27 (4)K 

0 

Non-Res, Addr:1541, 

KBM, 1US, R/W 

MOMODT 

COM 

DRO 

27 (4)K 

1 

Temp, 

Addr:849, 

KBM, 

1US, R/W, NER 


Format 

SHOW RUNTIME_SYSTEM 

Command Qualifiers Defaults 

/[NO]OUTPUT[=filespec] your terminal 

Prompts 

none 


Command Qualifiers 

/[NO]OUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 
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12.6.22 UNLOAD/LIBRARY Command 


This command removes the resident library you specify from memory. 
UNLOAD/LIBRARY requires INSTAL privilege. 


Format 

UNLOAD/LIBRARY library-name 

Command Qualifiers 
none 

Prompts 

Library: 


Command Parameters 

library-name 

Specifies the name of the resident library to remove from memory. 
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Jobs already logged in to the system can continue running. However, jobs such 
as BATCH that create logged-in jobs cannot successfully process further requests. 
(The SHUTUP system program also disables further logins in preparing to shut 
down timesharing.) 

If you try to connect to RSTS/E over a LAT line and get the message "?Logins 
are disabled — please try again later", RSTS/E does not disconnect the session. 
Instead, the terminal waits for logins to become enabled. When logins are 
enabled, you can start the login sequence by pressing Return. If you want to get 
back to the LAT prompt, use the local key sequence, usually the Break key. 

To keep you from being locked out of the system, RSTS/E allows jobs to be logged 
in at the system console terminal (KBO:), regardless of the number of logins 
currently allowed. (This feature is a special characteristic of the terminal you 
designate as the system console; the default is KBO:. By installing a feature 
patch, you can change the terminal which has this characteristic. However, only 
one terminal on a system can have this capability.) This capability remains in 
effect as long as a job slot is available to handle a new job. You need SWCTL 
privilege to use the SET SYSTEM/NOLOGINS command. 

The SET SYSTEM/LOGINS command places a ceiling on the number of users 
that can log in to the system. This command is useful for limiting or extending 
the load allowed on the system. For example: 

$ SET SYSTEM/LOGINS=35 
$ 

This command limits the number of logins to 35; if there are 35 or more users 
logged in to the system, the next user who tries to log in gets the error message 
"?Logins are disabled — please try again later," and must wait until enough users 
log off before being allowed to log in. 

The system does not let you set the number of logins to zero or to a number 
greater than the value of JOB MAX set at system installation time. If you specify 
zero in the command, RSTS/E sets the number to one. The default number 
is JOB MAX. You need SWCTL privilege to use the SET SYSTEM/LOGINS 
command. 

The number of logins allowed can never exceed the capacity of the swap space 
installed on the system or the value specified during system generation. If you 
enter a number greater than the maximum allowed, RSTS/E sets logins to the 
maximum possible. The SHOW BUFFERS command or the DISPLY program 
includes the maximum number of logins currently allowed. 

You normally use the SET SYSTEM/LOGINS command with the 
INSTALL/SWAP_FILE command to adjust the number of logins allowed. After 
you add swap space to the system, the SET SYSTEM/LOGINS command performs 
these steps: 

1. Recalculates the swap capacity 

2. Factors in the currently allowed maximum swap size (SWAP MAX) 

3. Increases the number of allowed logins 

If you are preparing to remove swap space, use the SET SYSTEM/LOGINS 
command to decrease the number of allowed logins. 
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13.2 Broadcasting Messages to Terminals 


The BROADCAST command lets you communicate with one user or with all users 
on the system. You need SEND privilege to execute the BROADCAST command. 
This command places a specified text string in the output buffer of a terminal, or 
of all terminals, and displays the text on the terminal. For example, if a user at 
terminal KB32: assigns a peripheral device for an unreasonably long time, you 
can send a message asking the user to deassign the device: 

$ BROADCAST KB32: "Bob, can you deassign MMO: for me; I need it ASAP." 

$ 

By specifying /LOGGEDJN instead of a terminal designator, you can broadcast 
the message to each online terminal in the RSTS/E system (unless the terminal 
is set for NOBROADCAST). For example: 

$ BROADCAST/LOGGED_IN "Read $NOTICE.TXT; the system is coming down!!" 

$ 

The system displays your message as follows: 

*** From [1,214] "Account Name" on KB25: at 02:17 PM 27-May-90 
** Read $NOTICE.TXT; the system is coming down!! 

This message appears on all terminals that are on line and set to BROADCAST, 
except your own. 

You can direct your message to specific users by substituting a PPN for the 
destination specification. Wildcard characters are also permissible. For example, 
to broadcast a message to all users logged in under the same project number: 

$ BROADCAST [20,*] "Please attend a meeting at 3:00 PM today" 

You can send a multiline message with BROADCAST as follows: 

1. Press Return after the destination specification. RSTS/E displays the prompt 
Message: on your terminal screen. 

2. Enter your message, terminate each line by pressing Return. 

3. Enter Ctrl/Z to send your message. 

In a multiline message, you do not need to enclose the message in quotes. For 
example: 

$ BROADCAST/ALL<RET> 

Message: The power will be shut off in the building this weekend.<RET> 
Message: Therefore, this system will be taken down Friday night.<RET> 
Message: No logins will be allowed after 5PM on Friday.<RET> 

Message: <Ctrl/Z> 

$ 


13.3 Controlling Jobs 

The FORCE command lets you send a text string to another terminal (or all 
terminals). You need SYSIO privilege to use the FORCE command. The system 
places the text string in the input buffer of the specified terminal as if it were 
typed by the user. The command has the format: 

FORCE destination "command" 
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If you want to send a Ctrl/C to a terminal, KB32 in this case, to stop the 
execution of whatever is running at the terminal and then to log the user off the 
system, type: 

$ FORCE KB32: ,,A LOGOUT" 

$ 

The circumflex ( A ) character before the command forces a Ctrl/C to the terminal, 
and the LOGOUT command logs the user off the system. 

You can also send only a Ctrl/C ( A C) to a terminal by placing a circumflex 
character in the first position after the keyboard number. For example: 

$ FORCE KB32: ,,A " 

$ 

Do not place any text after the circumflex if you want to send only a Ctrl/C to the 
terminal to stop the job that is running. RSTS/E sends a Ctrl/C to the terminal 
and returns control to the keyboard monitor prompt. For example: 

A c 

$ 

To force a control character combination (Ctrl/Z for example) to a terminal, enter 
the circumflex ( A ) character as the first character of the text, followed by the 
proper control letter (such as Z). For example: 

$ FORCE KB32: ,,A Z" 

$ 

Typing A Z and pressing Return executes a Ctrl/Z at KB32: No other text 
should follow the control character combination. If the circumflex ( A ) is the first 
character of more than two characters of text, however, RSTS/E forces a Ctrl/C to 
the terminal before sending the text that immediately follows the first character. 
For example: 

$ FORCE KB32: ,,A ! Harry, sorry but your job is out of control!” 

$ 

The A C characters appear on Harry’s terminal to end the job he was running and 
the system prints the text of the message on the following line. (The text after 
the first character can contain up to 80 characters.) 


13.4 Removing Jobs 

The REMOVE/JOB/NOQUERY command lets you terminate a user’s job 
and remove it from the system. You need JOBCTL privilege to use the 
REMOVE/JOB/NOQUERY command. Before using REMOVE/JOB/NOQUERY, 
use the SHOW USER command to learn the user’s job number, then type: 

$ REMOVE/JOB/NOQUERY 10 
$ 

The monitor clears job 10 and frees it for other system use. The user is no 
longer logged in to the system and must log in again before attempting any other 
system activity. Use the SHOW USER command immediately after issuing the 
REMOVE/JOB/NOQUERY command to verify that the job is no longer on the 
system. 
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13.5 Placing a Job on HOLD 

There are times when you do not want to terminate a job, but rather want to 
place it in a hold state, a state from which it can resume normal processing. A 
job may be using up too many system resources, or you may be running a batch 
job that you need to correct. The SET JOB/HOLD command automatically sets 
the priority of a job to -128. This causes the system to stop giving the job any 
time to run. Use the SET JOB/HOLD command as follows: 

$ SET JOB/HOLD 10 
$ 

Job 10 stops processing but does not terminate. SET JOB/HOLD always sets 
the priority to -128, which means you cannot include a priority number with the 
command. You must reset the priority of the job to -120 or higher with the SET 
JOB/RELEASE command to reactivate the job. Use the SET JOB/RELEASE 
command as follows when you want to restart the job: 

$ SET JOB/RELEASE 10 
$ 

Now job 10 has the default priority of -8, which under normal system load allows 
the job to successfully run to completion. 

SET JOB/HOLD and SET JOB/RELEASE are the logical commands to use when 
you want to stop a job temporarily and then start it again. You need TUNE 
privilege to use the SET JOB/HOLD or the SET JOB/RELEASE commands. 


13.6 Setting Job Priority, Run Burst, and Maximum Size 

The system lets you set the priority, run burst, and maximum size of an existing 
job. You can change any of the current values to: 

• Increase or decrease the chance of gaining run time in relation to other 
running jobs 

• Determine how much CPU time the job can have when it is compute bound 

• Increase the area a job can occupy 

The system runs jobs on the basis of priority. The higher a job’s priority, the 
better its chances of obtaining run time in relation to other jobs that are running. 
Figure 13-1 shows how an 8-bit priority byte determines priority. 

Figure 13-1: Priority Byte Format 


xxxxxxxx 


Sign User-Definable System-Definable 

Bit Portion Portion 
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Using the SET JOB/PRIORITY command, you or another user can set the user- 
definable portion of the priority byte for any job on the system. Because the three 
system-definable bits are normally zero, standard priorities are multiples of 8 
between -120 (lowest priority) and +120 (highest priority). Zero is a legal priority. 
When the system changes a priority, it truncates any value not a multiple of eight 
to the next lowest legal priority. For example, if you specify a priority of +10, 
RSTS/E sets the value to +8. 

You need TUNE privilege to use the SET JOB/PRIORITY command. 

All of the system-definable bits are normally off (zero). The least significant bit is 
set when a keyboard delimiter is typed and the job is waiting for keyboard input 
or when any I/O completes. Keyboard delimiters are Carriage Return (CR), Line 
Feed (LF), Form Feed (FF), Control Z (Ctrl/Z), and Escape Sequence Character 
(ESC). The next significant bit is set whenever a Ctrl/C is entered and can be set 
at any time. Finally, a system function call sets the most significant bit of the 
system-definable portion. RSTS/E clears all system-definable bits when it chains 
to another program or when the job is at the system command level. 

The system-definable portion of the priority byte is always less significant than 
the user-definable portion. Therefore, the system-definable bits affect priority 
only within the user-definable priority range. For example, if two jobs are run¬ 
ning under priority -8, the user who enters a Ctrl/C has a higher priority (that is, 
priority -6 in this case) than the user who does not. However, a third user with 
priority 0 supersedes two users whose priorities are -8 and -6. 

When you log in, LOGIN runs with priority 0 and automatically sets your job to 
priority -8. This is the default priority with which most or all jobs are run. Do 
not assign priorities other than -8 except in unusual circumstances (for example, 
compute-bound or detached jobs). On occasion, you may want to rim a program 
that requires a great deal of computation. If time is not a factor in obtaining 
results, and you have TUNE privilege, you can decrease the job priority of the 
compute-bound job to improve efficiency for the other users on the system. On 
the other hand, infrequently used detached programs often have higher priorities 
(typically priority 0) because they must run quickly when needed but do not run 
compute bound for an extended period and do not run often. 

Run burst is the maximum time a job can run compute bound before another job 
obtains access to the CPU. On systems using the KW11L line frequency clock, 
each unit of run-burst time is equal to l/60th or l/50th of a second, depending 
on the system’s power line frequency. Systems running with the KW11P clock at 
crystal speeds, rather than at line frequency, have a run-burst unit of l/50th of 
a second. If the system is operating from a 60 Hz power line, one run-burst unit 
equals l/60th of a second. In that case, six units equal l/10th of a second, which 
is the run-burst default value. 

If you assign a run burst of six to a specific job that does not require much 
compute-bound time, the system automatically transfers control to the next user 
before the six units have been used. One tenth of a second is generally considered 
the best run-burst time period to ensure efficient overall system operation. If a 
job is guaranteed to become I/O bound (that is, I/O stalled) after a certain amount 
of computation, use SET JOB/RUN_BURST to specify a run burst larger than 
six. In many cases, a run burst greater than six has a significant effect on long 
computational programs. Their percentage of the overall CPU time would be 
increased. 

You need TUNE privilege to use the SET JOB/RUN_BURST command. 
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The maximum size assigned to a job refers to the allowable memory space. 

You can restrict certain jobs to run only programs smaller than 32K words (or 
SWAPMAX) by assigning a job a size smaller than the current SWAPMAX. This 
assigned limit does not affect privileged, compiled programs. Thus, a user with 
a small amount of space can still run system programs that would normally 
exceed the memory limit. Tb alter the maximum job size of job 14, use the SET 
JOB/SIZE command as in the following example: 

$ SET JOB/SIZE=16 14 

You need TUNE privilege to use the SET JOB/SIZE command. 


13.7 Controlling Keyboards and Remote Lines 

If you determine that a dataset line is in use but no keyboard activity is taking 
place (by using SYSTAT or the DISPLY program job status report), you can 
disconnect the dataset. The HANGUP command disconnects the remote line 
specified by the KBn: keyboard. The hangup capability prevents a user from 
monopolizing the line without being charged for connect time and frees the 
line for other remote users. You need HWCTL privilege to use the HANGUP 
command. 

The DETACH command frees a terminal from its job. If the job does not have the 
terminal open on a nonzero channel, DETACH frees the terminal for other use. 
The command normally forces the system to close all nonzero channels on which 
the terminal is open. The /NOCLOSE switch suppresses this action. When the 
job specified is currently detached, the monitor prints the error message: 

?Job number x is already detached. 

You need JOBCTL privilege to use the DETACH command (except for your 
current job). 


13.8 DCL Command Descriptions 

The following sections describe the DCL commands that you can use for job 
management. 
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13.8.1 ATTACH Command 


This command attaches a terminal to a job. ATTACH does not require any 
privileges. 


Format 

ATTACH job-number 

Command Qualifiers 
none 

Prompts 

job-number: 


Command Parameters 

job-number 

The number of the job you want to attach to. 
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13.8.2 BROADCAST Command 


This command lets you communicate with one user or with all logged-in users. 
You need SEND privilege, sends a message to: 

• A specified terminal (KBn:) 

• All users logged in under a specified PPN (the PPN can contain wildcard 
characters) 


NOTE 

This command displays a message only on terminals that are not set to 
NOBROADCAST. 


Format 

BROADCAST destination[,...] "message" 


Command Qualifiers Defaults 

/ALL none 

/[NOJBELL /NOBELL 

/[NOJHEADER /HEADER 

/LOGGEDJN none 


Prompts 

To: 

Message: 


Command Parameters 

destination 

The device(s) or accounts) where the message is to be displayed. For multiple 
destinations, enter the individual keyboards separated by commas. For example: 

$ BROADCAST [4,*],KB23:,KB5 "Please log off." • 

"message" 

The message to be displayed on the destination device(s). If you press Return 
after entering the destination specification, DCL prompts you for each line of a 
message. Enter Ctrl/Z to send the message. Note that when you enter a multiline 
message in this way, do not enclose the message in quotes. 

Command Qualifiers 

/ALL 

Broadcasts the message to all terminals. 

/[NOJBELL 

Broadcasts a BELL character before the message. The default is /NOBELL. 
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/[ NOJHEADER 

Broadcasts a header before the message. The header is in the format: 
From ARK::[1,194] "Account Name" on KB52: at 11:52 AM 30-May-85 

The default is /HEADER. 

/LOGGEDJN 

Broadcasts the message to all logged-in terminals. 
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13.8.3 DETACH Command 


This command detaches a job from its terminal. DETACH requires JOBCTL 
privilege to detach any job other than your current job. 


Format 

DETACH job-number 

Command Qualifiers Defaults 

/[NOjCLOSE /CLOSE 

Prompts 

job-number: 


Command Parameters 

job-number 

The number of the job you want to detach from its terminal. 

Command Qualifiers 

/[NOJCLOSE 

Indicates whether the system closes all nonzero channels on which the job’s 
terminal is open before detaching. The default is /CLOSE. 
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13.8.4 FORCE Command 

This command forces a string to one terminal or all logged-in users. You need 
SYSIS privilege. 

• A specified terminal 

• All users logged in under a specified PPN. The PPN can contain wildcards. 


Format 

FORCE destination[,...] "string” 

Command Qualifiers Defaults 

/ALL none 

/LOGGEDJN none 

Prompts 

To: 

Command: 


Command Parameters 

destination 

The device(s) that you want the "string" forced to. For multiple destinations, 
enter the individual devices, separated by commas, for example: 

$ FORCE [4,*]KB23:,KB5 " A $LOGOUT" 

"string" 

The string that you want forced to the destination device(s). 

Command Qualifiers 

/ALL 

Forces the string to all terminals. 

/LOGGEDJN 

Forces the string to all logged-in terminals. 
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13.8.5 HANGUP Command 


This command disconnects the specified remote line. HANGUP requires HWCTL 
privilege. 


Format 

HANGUP KB[c]nn: 

Command Qualifiers 
none 

Prompts 

Keyboard: 


Command Parameters 

KB[c]nn: 

Specifies the remote line you want to disconnect. 


Job Management 13-13 










13.8.6 LOGIN Command 


This command is used to do the following: 

• Create a new job at the specified terminal. You can use this feature in your 
system startup procedure to log in various users automatically. You need 
WACNT or GACNT privilege to create a new job. If the terminal is restricted, 
you also need DEVICE privilege. 

• Log your current job in under a different account. This feature lets you switch 
between accounts without having to first issue the LOGOUT command (see 
RSTS /E System User s Guide). You need WACNT or GACNT privilege to log 
in to a different account without being prompted for that account’s password. 

• Reset your current job to its initial logged-in state (the state your job was 
in after logging in). This feature is useful for resetting logical assignments, 
DCL symbols, prompts, and so on to their initial state. This feature does not 
require any privilege. 

The LOGIN command sends its messages to OMS. If OMS is not running, the 

messages are sent to KBO:. 


Format 

LOGIN [p,pn] 

Command Qualifiers Defaults 

/[NO]OVERRIDE[=NOLOGINS] /NOOVERRIDE 
/TERMINAL=terminal[:] Your terminal 

Prompts 

Password: 


Command Parameters 
[P>pn] 

The PPN for the account you want to log in to. The default PPN is your PPN. 
You can also use a system logical name in place of a PPN. The logical name must 
translate to a valid PPN. If the logical definition includes a device, the device 
must be either SY: or SYO:. 

Command Qualifiers 

/[NO]OVERRIDE[=NOLOGINS] 

Indicates whether to create the new job if logins are currently disabled. Specify 
/OVERRIDE or /OVERRIDE=NOLOGINS to create the new job even if logins are 
disabled. If you attempt to create a new job with the /NOOVERRIDE qualifier 
and logins are disabled, the monitor displays an error message. The default is 
/NOOVERRIDE. The /OVERRIDE qualifier requires that you also specify the 
/TERMINAL qualifier. /NOOVERRIDE is the default. 
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NOTE 


Even with /OVERRIDE in effect, you cannot create a new job unless 
there are job slots available on the system. 

/TERMINAL=terminal[:] 

Indicates that a new job should be created at the specified terminal. The terminal 
argument can be any valid device name that refers to a keyboard device. If the 
terminal you specify is restricted, you must have DEVICE privilege. You must 
have WACNT or GACNT to log in to another account on the specified terminal. 
Your terminal is the default. 

The following examples show the different features of LOGIN. Tb reset your job 
to its initial logged-in state, enter: 

$ LOGIN 

Tb log in to account [10,10], enter: 

$ LOGIN [10,10] 

Password: 

You must then supply the correct password. If you have WACNT or GACNT 
privilege and you are switching from any [10,*] account, the monitor lets you log 
in without prompting you for the password. 

Tb log in user [100,3] at terminal KB11: while you are working at another 
terminal, enter the following: 

$ LOGIN/TERMINAL=_KBl1: [100,3] 

You must have WACNT privilege, or have GACNT privilege and be logged in to 
a [100,*] account to execute the previous command. You must have the DEVICE 
privilege, or you must have __KB11: set to NORESTRICT. 
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13.8.7 REMOVE/JOB Command 


This command immediately terminates the specified user job and logs it out. 
REMOVE/JOB requires JOBCTL privilege. 


Format 


REMOVE/JOB job-number 


Command Qualifiers 

/[NO]CONFIRM 

/[NOJQUERY 


Defaults 

/CONFIRM 

/QUERY 


Prompts 
Job number: 


Command Parameters 

job-number 

Specifies the job to remove. 

Command Qualifiers 

/[NOjCONFIRM 

Causes a SHOW JOB display for the job you want to remove, then asks if you 
really want to remove the job just displayed. /CONFIRM is the default. 

/[NOJQUERY 

Synonym for the /[NOJCONFIRM qualifier. /QUERY is the default. 
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13.8.8 SET JOB Command 


This command defines the characteristics of the specified job. The 
/KEYBOARD_MONITOR and /PRIVILEGE qualifiers can only be used for the 
current job. If you specify those qualifiers with a job number other than your 
own, RSTS/E displays the following error message: 

?Only current job allowed. 

SET JOB requires TUNE privilege to use any of the qualifiers except 
/PRIVILEGE and /KEYBOARD_MONITOR. 


Format 

SET JOB ljob-number] 

Command Qualifiers 
/HOLD 

/KEYBOARD_MONITOR[=name] 

/PRIORITY[=n] 

/PRIVILEGE=(priv[,...]) 

/RELEASE 
/RUN_BURST[=n] 

/SIZE=n 

Prompts 

Job number: Displayed if you use the /HOLD qualifier 


Defaults 
No change 
none 

/PRIORITY=-8 

none 

none 

/RUN_BURST=6 

none 


Command Parameters 

[job-number] 

Specifies the job whose characteristics you want to define. If you leave off the job 
number, the default is your own job number. 

Command Qualifiers 

/HOLD 

Sets the priority of the specified job to -128. This qualifier cannot be used for the 
current job. No change is the default. 

/KEYBOARD_MONITOR[=name] 

Sets the current job’s keyboard monitor to name. The allowable values of name 
are any installed run-time system that has a keyboard monitor. Use the SHOW 
RUNTIME_SYSTEM command to list the run-time systems on your system. If 
you omit the optional argument, DCL becomes the current job’s keyboard monitor. 

/PRIORITY[=n] 

Sets the priority of the specified job. Priority can be any number from -128 to 
+120. The system rounds the priority down to a multiple of eight. (For example, 
if you select a priority of -19, the system sets the priority to -24.) If you do not 
specify a priority value, the default is -8. 
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/PRIVILEGE=(priv[,...]) 

Modifies the set of current privileges for the current job only. 

/RELEASE 

Resumes job n at priority of -8. 

/RUN_BURST[=n] 

Changes the run burst of the specified job. The value for n can be any number 
from 1 to 127. If you do not specify a run burst value, the default is 6. 

/SIZE=n 

Changes the maximum size of the specified job. You can set n to a maximum 
of 32K, or 64K for I&D space machines. The system automatically lowers any 
higher value to the maximum allowed. 
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13.8.9 SET SYSTEM Command 


This command sets the default system characteristics. You need SWCTL privilege 
to use the /LOGINS qualifier. Example: 

SSET SYSTEM/NOLOGINS 

See Chapter 8 and Chapter 14 for additional SET SYSTEM command qualifiers. 


Format 

SET SYSTEM 

Command Qualifiers Defaults 

/[NO]LOGINS[=n] JOB MAX 

Prompts 

none 


Command Qualifiers 

/[NO]LOGINS[=n] 

Defines the maximum number of users who can log in to the system at one time. 
Set /LOGINS=n to the number of user jobs that can log in to the system at one 
time. The default is JOB MAX. Specify /NOLOGINS if you want to prevent users 
from logging in to the system by setting the number of logins to one. 
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13.8.10 SHOW JOB/PRIVILEGE Command 


This command displays the set of current privileges for the specified job. SHOW 

JOB/PRIVILEGE requires JOBCTL privilege to display the privileges of another 
job. 


Format 


SHOW JOB/PRIVILEGE [job-number] 

Command Qualifiers Defaults 

/[NO]OUTPUT[=filespec] your terminal 

Prompts 

none 


Command Parameters 

[job-number] 

Specifies the job whose current privileges you want to display. The default is the 
current job. 

Command Qualifiers 

/[NO]OUTPUT[=f i lespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 
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Chapter 14 

Miscellaneous System Management Functions 


This chapter describes miscellaneous DCL commands that you use to manage 
your RSTS/E system. Table 14-1 summarizes the DCL commands available to 
you. The rest of this chapter explains each command in more detail. 


Table 14-1: DCL Commands for Miscellaneous System Functions 


Command 

Description 

LOAD/INDEX 

Loads SAT into memory. 

LOAD/OVERLAY 

Loads one or more monitor overlays in memory. 

SET DATE 

Sets the RSTS/E system date to the value you specify. 
Optionally, you can specify a new value for the system time. 

SET SYSTEM 

Sets the default system characteristics. 

SET TIME 

Sets the RSTS/E 24-hour clock to the value you specify. 
Optionally, you can set the system date to the value you 
specify. 

SHOW SYSTEM 

Displays the system-default characteristics. 

UNLOAD/INDEX 

Unloads SAT from memory. 

UNLOAD/OVERLAY 

Unloads one or more monitor overlays from memory. 


14.1 Loading and Unloading SAT 

The LOAD/INDEX and UNLOAD/INDEX commands let you load and unload the 
disk Storage Allocation Table (SAT) into memory during timesharing. Each disk 
on the system has a SAT, which is called SATT.SYS. 

The SAT is a 1 to 16 block permanent structure on all file-structured RSTS/E 
disks. Its purpose is to provide the file processor with a table of allocated or 
unallocated pack clusters, so that the processor can obtain new disk space for 
file structures. By default, whenever new disk space is allocated on the disk, the 
system updates the SAT and rewrites it to the disk, showing the true state of 
in-use disk space. 

The LOAD/INDEX and UNLOAD/INDEX commands let you optionally create 
a SAT that is resident in memory during timesharing. This feature improves 
system performance because the RSTS monitor does not need to perform disk 
I/O to the SAT on a per-disk unit basis. By allocating the appropriate amount of 
XBUF, you can make the SAT for each disk unit completely memory resident, so 
that a write to the disk occurs only when the disk unit is logically dismounted. 
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NOTE 


Because the resident SAT feature improves system performance at the 
expense of memory, be sure to calculate the amount of XBUF needed 
according to the number and size of any resident SATs desired before 
starting timesharing. 


14.2 Loading and Unloading Monitor Overlays 

The LOAD/OVERLAY and UNLOAD/OVERLAY commands let you load and 
unload monitor overlays during timesharing. You can use these commands in 
conjunction with the DISPLY program and the SHOW CACHE command to 
monitor the effects on your system's performance of making certain overlays 
resident or nonresident. 

The monitor overlays that you can specify with these commands are: 

• ATTRIBUTE — Performs file and account attribute read/write operations 

• DCL — Performs file-related operations for DCL 

• DELETE_RENAME — Performs file deletion and renaming 

• DIRECTORY — Performs disk file lookup operations 

• SYSTEM_CALLS — Performs specific monitor directives 

• TERMINAL — Performs terminal characteristic SET and SHOW operations 


14.3 Suspending System Operations 

The SET SYSTEM/HOLD and SET SYSTEM/RELEASE commands let you 
temporarily suspend all disk I/O and other system operations. When you issue 
the SET SYSTEM/HOLD command, all jobs on the system are suspended, except 
for the job issuing the command. Operations resume when you issue the SET 
SYSTEM/RELEASE command. 

The SET SYSTEM/HOLD and SET SYSTEM/RELEASE commands are used 
primarily on systems where the system disk is an RC25. The main reason for 
using these commands is to suspend operations when you need to stop the fixed 
disk drive so you can mount a different disk cartridge (both disks share the 
same spindle). With SET SYSTEM/HOLD and SET SYSTEM/RELEASE, a total 
system shutdown is not necessary. You need HWCTL privilege to use the SET 
SYSTEM/HOLD and SET SYSTEM/RELEASE commands. To use the commands, 
type: 

$ SET SYSTEM/HOLD 
System now on hold 
$ 

The system displays the message System now on hold to show that the suspend 
is in effect. When the disk stops, you can change the removable cartridge. When 
you are ready to resume system operations, type: 

$ SET SYSTEM/RELEASE 
System released 

$ 
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14.4 Changing System Date and Time 

The SET DATE and SET TIME commands let you change the system date and 
the 24-hour clock. These commands are important on systems where strict 
accounting data is kept and incorrect values may have been entered at system 
startup time. You can enter the date in either of two formats: 

SET DATE dd-mmm-yy 
SET DATE yy.mm.dd 

The following example shows how to enter the date using the first format: 

$ SET DATE 30-MAY-90 

You can enter the same date in the second format as well: 

$ SET DATE 90.05.30 

Be sure to place a space between the DATE command and the beginning of the 
date field when entering a date with either format. You need DATES privilege to 
use the SET DATE or SET TIME command. 

You can enter the time in either of two formats: 

SET TIME 01:30PM 
SET TIME 13:30 

You change the date and/or the time with either command as follows: 

For SET DATE; 

$ SET DATE 30-MAY-90 
$ SET DATE 30-MAY-90:01:30PM 

For SET TIME; 

$ SET TIME 01:30PM 
$ SET TIME 30-MAY-90:01:30PM 

Note that when you specify both parameters, you must first enter the date and 
separate the two parameters with a colon. 

You can also specify a relative date and time with the SET DATE command. For 
example: 

SET DATE -1DAY 
SET TIME +1HOUR 

The first command, when executed, sets the system date back a day. The second 
command, when executed, adjust the system time ahead one hour. You can use 
relative values to make minor adjustments in the system date or time. Relative 
date and time syntax is as follows: 

+nnDAYS 

+nnHOURS 

+nnMINUTES 

You can string the keywords together in any order and you can abbreviate them 
to one character. If you specify an absolute date and time, it must appear first in 
the date-time specification. An example of mixed absolute and relative date and 
time would be: 

SET DATE 10-MAY-90:4:OOPM+3DAYS+2HOURS-45MINUTES 
This would be equivalent to: 

SET DATE 13-MAY-90:5:15PM 


Miscellaneous System Management Functions 14-3 








14.5 Recording System Activities: EMT Logging 

An EMT is a PDP-11 assembly language instruction through which a program 
requests services from the monitor (for example, opening and closing a file, 
performing I/O, and logging in or out.) EMT logging is an optional feature that 
provides a “window" on the process by which timesharing jobs request and 
receive services from the RSTS/E monitor. Thus, EMT logging lets you gather 
information about the activity on your system. 

For example, you might want to know the following information about your 
system: 

• The number of logins on a particular terminal 

• How many files are accessed on a certain drive 

• Which nonresident FIP overlays get the heaviest use 

Such information can help you improve system performance, identify bottlenecks, 
establish fee setting algorithms, and watch for potential security problems. 

This section describes the EMT logging feature; the advantage and impact of 
using it, how it works, and how to include it in your system. However, because of 
the wide variety of RSTS/E systems, you must decide which data is most useful in 
your environment, and how to collect and use the data the EMT logger provides. 

EMT logging includes optional code in the monitor, uses XBUF to pass informa¬ 
tion, and requires an EMT logging program, running as a timesharing job. You 
can create your own EMT logging program, or use the sample provided. See the 
EMTCPY.BAS and EMTCPY.TSK files in the UNSUPP$ account. The use of EMT 
logging can affect performance. This effect depends on which EMTs you decide to 
log, for which jobs you log them, and how much processing your logging program 
does for each EMT. 

EMT logging provides information on timesharing activity in terms of what the 
monitor sees. The data returned to your logging program is in terms of FIRQB 
and XRB contents, regardless of the programming environment of the job that 
issues the directives. See the RSTS/E System Directives Manual for information 
on the FIRQB and XRB, as well as descriptions of the MACRO form of system 
directives. 


14.5.1 EMT Calls 

The RSTS/E monitor provides an extensive set of services for use by CUSPs, 
run-time systems and user applications. Programs request these services by 
issuing calls to the monitor, referred to as monitor directives (by MACRO 
programmers) or SYS() Calls. Some language constructs, such as the BASIC- 
PLUS OPEN statement, are translated by the program’s Object-Time System 
(OTS) or Run-Time System (RTS) into the appropriate monitor directive. 

These calls to the monitor generate EMulator Trap (EMT) instructions, special 
PDP-11 instructions that interrupt the program (or its OTS or RTS) so that the 
monitor can process the request. Once the request is completed, control returns 
to the calling program. These monitor calls are also referred to as EMT calls. 

Different monitor directives generate different EMT codes. For example, the 
CALFIP directive generates EMT code 0, while the .RUN directive generates code 
42 8 . Some directives, like .RUN, perform a single action (run a program), while 
other directives, like .UUO, can perform a variety of actions depending on a sub¬ 
function code passed with the directive. See Chapter 3 of the RSTS/E System 
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Directives Manual for a complete list of monitor directives and their associated 
EMT codes. 

To issue a monitor directive, a MACRO program typically first loads any required 
data into one or two special data structures — called the FIRQB (File Request 
Block) and XRB (Transfer Request Block) — and then issues the call. For 
programs written in high-level languages, such as BASIC-PLUS, the program’s 
OTS or RTS actually stores and retrieves data in the FIRQB and XRB. Upon 
completion, the monitor returns information to the program through these 
same data structures. The returned data typically includes the call’s exit status 
(success or error) and other information related to the call. 


14.5.2 Why Use EMT Logging? 

EMT logging provides a way to capture certain events during timesharing. These 
events represent requests for monitor services by programs. Since almost all 
RSTS/E activities are based on EMT calls to the monitor, it is possible to log 
selected events when they occur. For example, if you want to keep a record 
of each time an account is deleted on your system (the date/time of deletion, 
the device/PPN of the account deleted, and the PPN of the user who deleted 
the account) you can modify the ACTMGR CUSP to write an entry in a log 
file whenever someone issues a DELETE/ACCOUNT command. EMT logging 
provides a much easier way to accomplish this task. By logging the DLU (Delete 
User Account) EMT call, you can capture all requests to delete an account, even 
those that were issued from a program other than ACTMGR.TSK. Since all DLU 
calls are logged (including those that fail) you can even capture attempts to delete 
an account. 


14.5.2.1 Security 

System security can be enhanced by monitoring certain EMT calls that perform 
restricted or high-risk operations, such as changing an account’s privileges or 
changing the system password. By logging these calls, you can: 

• Create security alarms , where the system manager is notified whenever a 
security-related request occurs. When an alarm occurs, the EMT logging 
program notifies the system manager (via a BROADCAST command or 
electronic mail). 

• Provide security audit trails, where you maintain a complete history of all 
security-related events. Should a security violation occur in the future, an 
audit trail allows you to reconstruct the conditions leading up to the problem. 

Because EMT logging is provided by the monitor itself instead of the individual 
program(s) issuing the EMT calls, there is less chance of missing any security- 
related event. 
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Table 14—2 lists the most common security-related EMT calls that can be logged. 
Because EMT logging can degrade overall system performance, you should care¬ 
fully determine your logging needs before enabling any EMT call for logging. 


Table 14-2: 

Security-Related EMT Calls 

EMT Call 

Security Function 

ATR 

Read/Write account/file/disk attributes, delete account attributes 

ATT 

Attach, reattach job 

BCK 

Change file backup statistics 

CFG 

Set system defaults 

CHU 

Set password, kill job, disable terminal, change quotas 

DAT 

Change system date/time 

DLU 

Delete user account 

FIL 

File utility functions 

JOB 

Create a job 

LIN 

Login, verify password 

PAS 

Create user account 

POK 

Poke memory 

RAD 

Read and reset accounting data 


The information that EMT logging provides may be helpful in checking and 
maintaining system security. However, the use of EMT logging as a system 
security tool depends on many site-specific factors: 

• The types of events that can be watched for 

• The degree of security required 

• The way that EMT logging is set up 

• The experience and judgement of the system manager who sets up EMT 
logging and interprets its data 

• The general security practices of the site 


14.5.2.2 Monitoring Usage 

EMT logging can be used to monitor the use of your system or identify perfor¬ 
mance hot spots on your system. For example, you may want to find out how 
often a particular file is being opened, or how often a program is being run. EMT 
logging offers a simple way to capture such activity. Because EMT logging itself 
may degrade system performance, disable logging once you have gathered the 
necessary information. 

You can also use EMT logging to determine which monitor calls are performed 
on behalf of a program-level function. Often, what appears as a single function 
to the user may actually be many different monitor functions. You may need to 
enable many EMT calls to accomplish this analysis. Since some EMT calls are 
used in a wide variety of services (such as OPN, the file open directive). Use your 
system standalone or during off-peak hours to explore EMT logging capabilities 
on your system. 
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14.5.3 EMT Logging Impact 

EMT logging imposes additional monitor overhead capturing EMT calls and 
sending EMT data to an EMT logging receiver. The impact varies depending on 
the number and type of EMT calls being logged, and the system’s CPU capacity. 

When using EMT logging on your system, follow these general guidelines: 

• Only log those EMT calls that you need. Do not log all (loggable) EMT calls 

• Disable EMT logging when it is not required. 

• Experiment with EMT logging first to learn the impact of logging on your 
system. 

• Adjust the EMTCPY program’s parameters to minimize impact on the system. 


14.5.4 Anatomy of EMT Logging 

The EMT logging process is a co-operative process between: 

• The monitor, which captures EMT call information 

• The EMT logging program, which processes EMT information sent to it by the 
monitor 

• The SHUTUP utility, which sends a shutdown message to the EMT logging 
program (if present) as part of the normal system shutdown process 

Figure 14-1 illustrates the relationship between the three EMT Logging compo¬ 
nents. The sections that follow describe the roles of each of these components. 

Figure 14-1: EMT Logging Process 



Miscellaneous System Management Functions 14-7 





















14.5.5 Programming for the EMT Logger 

lb use EMT logging, you must: 

• Include optional code in your monitor at system installation time. 

• Supply a program to process the data extracted by the monitor code. This 
program retrieves extracted data by send/receive calls. 

During the system installation dialogue, RSTS/E asks you: EMT Logging? Enter 
YES to create a monitor that can extract EMT information and pass it to your 
program. 

After creating the proper monitor, you must enable logging for the desired EMT 
information. Use the SET SYSTEM/EMT__LOGGING command to do this. You 
can use the same command to disable logging for EMT information you no longer 
want. For example: 

$ SET SYSTEM/EMT_LOGGING=(NOCRE , NODLN,ASS,DEA) 

This command disables logging for creating files (CRE) and deleting files (DLN), 
while at the same time enabling logging for assigning devices (ASS) and deassign¬ 
ing devices (DEA). You need the SWCTL privilege to use the /EMT_LOGGING 
qualifier on the SET SYSTEM command. 

The exact logging you choose affects performance. If you choose very common 
actions, the monitor must take out more time to log them, lb keep track of the 
current EMT logging, use the SHOW SYSTEM/EMT_LOGGING command. This 
command displays the current logging status of all EMTs. For example: 

$ SHOW SYSTEM/EMT LOGGING 


Code 

Mnemonic 

Description 

Status 

Code 

Mnemonic 

Description 

Status 

CALFIP functions: 

0 CLS Close a channel 

Disabled 

2 

OPN 

Open a channel 

Disabled 

4 

CRE 

Create a file 

Disabled 

6 

DLN 

Delete a file 

Disabled 

8 

REN 

Rename a file 

Disabled 

10 

DIR 

Directory info 

Disabled 

16 

RST 

Reset channels 

Disabled 

18 

LOK 

File lookup 

Disabled 

20 

ASS 

ASSIGN a device 

Enabled 

22 

DEA 

DEASSIGN dvice 

Enabled 

24 

DAL 

DEASSIGN all 

Disabled 

26 

CRT 

Create .TMP 

Disabled 

28 

CRB 

Create compiled 

Disabled 

30 

RUN 

Run a program 

Disabled 

UUO functions 
-29 TB3 

Tables III 

Disabled 

-28 

SPL 

SPOOL request 

Disabled 

-27 

DMP 

Snapshot dump 

Disabled 

-26 

FIL 

File utility 

Disabled 

• 

• 

You need no special privilege 

to use 

• • • 

the SHOW SYSTEM/EMT_LOGGING 


command. 


Your logging program is a normal timesharing job. You can design the program to 
do such activities as: 

• Select pertinent data 

• Maintain a log file 

• Signal events on one or more terminals 

• Control your system while it is running 

RSTS/E never logs EMTs for certain jobs, including the Error Logger (ERRCPY) 
and your EMT logging program itself; in addition the monitor does not allow you 
to log certain EMTs. 
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14.5.6 How EMT Logging Works 


If EMT logging is available and active, the monitor inspects each EMT as it is 
received. (’'Available" means installed in the system; "active" means that your 
EMT logging program has properly declared itself as a receiver.) If the newly- 
received EMT is one that RSTS/E logs, the monitor builds a packet of information 
about the directive and stores the packet in XBUF. Note that EMT logging does 
not use small buffers for message transfer. 

The packet contains: 

• Context data, such as date and time, user job number, and keyboard number 

• Directive data, such as information from the job’s FIRQB and/or XRB 

When the directive is complete, additional information (for example, the RSTS/E 
error code) is added to the packet. The packet is then made available to your 
program. Your program can inspect the parameters passed from the user’s job 
to the monitor, determine the relevance of the directive being logged from the 
packet, and take the appropriate action. 

Your program retrieves EMT logging packets by issuing message receive calls. 
Parameters in the declare receiver call of your program specify: 

• How many packets constitute a message 

• How many packets can be outstanding at any time 

• How much XBUF the EMT logger can use 

Each message received by your logging program consists of the packets (one per 
selected EMT) plus control information. This control information includes a count 
of EMTs that may have been lost because one or more of the limits you set up at 
declare time has been exceeded. 

See the RSTS/E Programming Manual for a description of the use of message 
send/receive calls as well as specific information about the send/receive calls used 
for EMT logging. 


14.5.7 Data Returned by EMT Logging 

The meaning of the data returned by the logging program you write depends on 
the internal functioning of the monitor. For this reason, both the format and 
meaning of data returned are subject to change in future releases of RSTS/E. 
Digital reserves the right to change internal mechanisms and, therefore, makes 
no commitment to continue providing any specific part of the data described for 
this release of RSTS/E. 
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14.5.7.1 Loggable EMTs Enabled or Disabled by SET SYSTEM 

For RSTS/E Version 9.7 and higher, the following EMTs are available for logging: 

CALFIP functions: 


Code 

Mnemonic 

Description 

Code 

Mnemonic 

Description 

0 

CLS 

Close a channel 

2 

OPN 

Open a channel 

4 

CRE 

Create a file 

6 

DLN 

Delete a file 

8 

REN 

Rename a file 

10 

DIR 

Directory info 

16 

RST 

Reset channels 

18 

LOK 

File lookup 

20 

ASS 

ASSIGN a device 

22 

DEA 

DEASSIGN dvice 

24 

DAL 

DEASSIGN all 

26 

CRT 

Create .TMP 

28 

CRB 

Create compiled 

30 

RUN 

Run a program 

UUO functions 






Code 

Mnemonic 

Description 

Code 

Mnemonic 

Description 

-29 

TB3 

Tables III 

-28 

SPL 

SPOOL request 

-27 

DMP 

Snapshot dump 

-2 6 

FIL 

File utility 

-25 

ATR 

File attributes 

-19 

LOG 

Set Logins 

-18 

RTS 

RTS/reslib ctl 

-17 

NAM 

Set RTS name 

-15 

ACT 

Acctng data 

-14 

DAT 

Date/time ctl 

-13 

PRI 

Priority, etc. 

-12 

TB2 

Tables II 

-11 

BCK 

File stats ctl 

-9 

HNG 

Hangup dataset 

-8 

FCB 

FCB/DDB info 

-6 

POK 

Poke memory 

-3 

TB1 

Tables I 

-2 

NLG 

Logins <= 1 

-1 

YLG 

Logins <= max 

0 

PAS 

Create PPN 

1 

DLU 

Delete PPN 

3 

MNT 

Mount/dismount 

4 

LIN 

Login 

5 

BYE 

Logout 

6 

ATT 

Attach 

7 

DET 

Detach 

8 

CHU 

Password/quota 

10 

ASS 

ASSIGN 

11 

DEA 

DEASSIGN 

12 

DAL 

DEASSIGN all 

13 

ZER 

Zero a device 

14 

RAD 

Read acctg data 

15 

DIR 

Directory data 

16 

TRM 

Terminal char 

17 

LOK 

Wildcard lookup 

19 

CHE 

Cache ctl 

20 

CNV 

Date => ASCII 

23 

SWP 

Swap+ files ctl 

24 

JOB 

Spawn a job 

25 

PPN 

PPN lookup 

26 

SYS 

Job status 

27 

KMC 

Connect KMC 

29 

STL 

Stall system 

33 

ONX 

Open next file 

34 

CFG 

Configure sys 





In summary, although EMT logging does not guarantee improved system security, 
it can provide a very useful tracking mechanism. 


14.6 Monitoring System Status: SYSTAT 


During normal timesharing, there are many occasions when you need to monitor 
the status of your system. RSTS/E provides two system programs for this 
purpose: 

DISPLY Automatically displays system status information on your terminal. By 

default, the program displays the system status every 15 seconds; how¬ 
ever, you can specify a different interval. See the following section for a 
description of the DISPLY program. 

SYSTAT Displays the status of different parts of the system when you use various 

program switches. See the RSTS/E Utilities Reference Manual for a 
complete description of SYSTAT and the switches associated with it. 

The description of SYSTAT in this section gives a set of guidelines for using the 
SYSTAT program for more effective system management. Use SYSTAT to: 

• Prepare for system shut-down to learn what jobs are active and which disk 
devices and assignable devices are in use. 
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• Determine when the number of general small buffers becomes too 
low. You can then decide whether to use the DCL commands SET 
SYSTEM/NOLOGINS and SET SYSTEM/LOGINS to restrict the num¬ 
ber of users that can log in to the system. Note that you can also use the 
SHOW BUFFERS command to display the number of available general small 
buffers. 

• Check on the amount of free disk space. The disk status report in SYSTAT 
reflects the apparent number of free blocks on each disk on the system. For 
practical purposes, however, such as for allocating a file on the device, all free 
blocks that SYSTAT reports may not be usable. You may get the message ?No 
room for user on device when SYSTAT reports there are free blocks available. 
Note that you can also use the SHOW DISKS command to display the amount 
of free disk space. 

The file cluster size or the number of clusters you need can prevent a file 
from fitting on a device. For example, a file whose cluster size is 16 and 
whose length is 10 blocks may not fit on a device that SYSTAT reports to 
have 50 free blocks of file space remaining. The cluster size of 16 demands 
that 16 contiguous blocks of free space exist on the device before the file can 
be allocated to the device. In some cases, 16 contiguous blocks do not exist on 
a device and RSTS/E does not allow a file to extend to another physical device 
even though SYSTAT can give you some indication of the availability of free 
disk space. 

• Follow the progress of user jobs. You can determine if a job is stalled, waiting 
for resources on your system. If you notice that a run-time value of a job is 
not increasing (the value is printed in a job status report), it indicates that 
the job is stalled and waiting for an I/O device. One user job can allocate 

a device or keep an assignable device locked by having one file open. You 
can determine who the user is by examining the device status report that 
associates the busy device with the job number of the user controlling that 
device. You can then ask the user to free the device or, if that is not possible, 
you can use DCL commands to force the job off the system (FORCE) or 
seize the device (ALLOCATE/SEIZE). Note that you can also use the SHOW 
USERS and SHOW JOBS commands to display user job status. 

• Follow the progress of detached jobs. When SYSTAT reports a detached job in 
the HB (hibernate) state, you know the detached job is attempting to commu¬ 
nicate with its terminal. In this case, log in to the system at a free terminal, 
and then use the ATTACH command to attach the job to the terminal. Once 
you attach to the detached job, RSTS/E can display the messages from the 
job. Note that you can also use the SHOW JOBS/DETACHED command to 
display the status of detached jobs. 

• Check on the number of jobs on the system. The free buffer report lists the 
number of jobs currently logged in to the system and the maximum number 
of jobs allowed. These numbers are useful when you are adding and removing 
swap files. After adding the swap files and raising the logins allowed, you can 
check the free buffer report to confirm the success of the procedure. Before 
removing a swap file, check this report to make sure that the number of 
logins allowed is low enough to enable you to remove the swap file at some 
later time. Note that you can also use the SHOW SYSTEM command to 
display the number of jobs on the system. 
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14.7 Dynamic Display of System Status: DISPLY 


The DISPLY system program displays the system status on VT52, VT100, and 
VT200 series terminals. After you start the program and decide how frequently 
you want it to update the system status on the screen, the program runs until 
you interrupt its execution. The information DISPLY prints is similar to that of 
the SYSTAT program. Commands you type during the execution of the program 
can alter the information displayed on the screen. These commands let you 
choose only those portions of the system status you need to see. 

The program resides in the AUXLIB$: account with the protection code of <232>. 
This protection code lets all users run the program. If you want to restrict 
running the DISPLY program to users that have the WREAD privilege, change 
the protection code to <124>. 


14.7.1 Running the DISPLY Program 

The program prints an identification line and a question after you type the 
command line RUN AUXLIB$:DISPLY. They appear as follows: 

$ RUN AUXLIB$:DISPLY 

DISPLY V10.0 RSTS V10.0 EDERE 

Interval? 

If you want updates to occur every 15 seconds, press Return to accept the default. 
Otherwise, type the number of seconds you want to elapse between screen 
updates. You can include any combination of the switches in Table 14-3 in your 
response. If you select a program switch but do not specify an interval, the 
program again assumes the default and updates the screen every 15 seconds. 
Table 14-3 lists the DISPLY program switches. 


Table 14-3: DISPLY Program Switches 


Switch 

Meaning 

/[NO]DCA 

Indicates if the terminal can use direct cursor addressing to position 
the cursor on the screen. By default, DISPLY uses /DCA. 

/DET 

Detaches the job from this terminal or from the terminal you 
specify. 

/KBn: 

Prints the output at keyboard unit n if it is available. If you specify 
the /DET switch, the program runs detached. 

/n 

Specifies the number of lines to display. The value of n can range 
from 12 to 24. By default, DISPLY displays 24 lines. 

/PRIORITY 

Runs the program at a special priority instead of at the normal -8 
priority. Requires TUNE privilege. 

/[NOJTAB 

Indicates if the terminal can correctly process TAB characters. By 
default, DISPLY uses /TAB. 


When you include the /DET switch in response to the INTERVAL question 
to run the program detached, you interrupt execution and you can use the 
terminal for other work. As soon as you enter Ctrl/C to interrupt the display, 
the program prints a message telling you the terminal is available. When you 
release the terminal by logging out, the program automatically displays the 
status information on the screen as if it had not been interrupted. 
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Use Ctrl/C to stop the execution of the DISPLY program. The procedure you 
follow after stopping the program depends on whether you were running the 
program attached or detached. If you are running the program attached, entering 
Ctrl/C to end the program returns control to the keyboard monitor. When running 
the program detached, entering Ctrl/C causes the program to print the following 
message before terminating: 

The terminal is all yours now 

You must then attach the job running the program to the terminal as follows: 

HELLO 1,2 <RET> 

PASSWORD: 

Jobs detached under this 
Job What Size State 
10 DISPLY 16 SL 
Job number to attach to? 

$ Continue <Yes>? N<RET> 

When the program attaches to the terminal as a result of the HELLO command, 
it prints the CONTINUE question. Finally, type NO or any other string not 
beginning with Y and press Return to terminate the program. 

The program displays on your terminal an identification line at the top line of 
the screen, skips a line, and fills the left portion of the screen with job status 
information and the right side with information about: 

• Busy devices 

• Disks 

• Run-time systems 

• Message receivers 

• Free buffers 

• Resident libraries 

After the screen is full, the program moves the cursor to the first character on the 
second line of the screen. The program is then idle, waiting to cycle through the 
display again. 

At the specified interval, the program checks the system tables and updates 
the status information on the screen with any changed data. While executing 
routines to extract update information, the program prints the message: 

WORKING... 

It leaves the cursor to the right of the message. After the update is complete, the 
cursor returns to its idle position. 

While the cursor is in the idle position, you can type commands to modify the 
contents and arrangement of items on the screen. End the command line by 
pressing Return. The program prints no message or takes no action on invalid 
statements. 

Some commands that add items to the screen take the minus (-) sign as a prefix. 
A command with a minus sign preceding it causes DISPLY to delete rather than 
add a display of the information that would normally appear without the minus 
sign. That is, the minus sign negates the effect of the command. 


account: 

Run-time RTS 

5.6 ...RSX 

<RET> 
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Table 14—4 lists the commands you use (usually while the cursor is in its idle 
position) to delete or add system status information. 


Table 14-4: DISPLY Program Commands 


Command Type Format and Description 


General 

C 

Clears the screen and displays new status. 

Sn 

Displays memory status in place of job status. Starts with the 
8K-word section less than or equal to n. If n is not given, starts at 
the beginning of memory. 

J 

Displays job status in the standard manner. 

Jn 

Displays job status starting with active job n+1. Overcomes 
physical limitation of the screen. 

Xn 

Changes the interval to n seconds. 

XO 

Updates the display with an interval of 0 seconds (that is, runs 
continuously) but lowers the priority so that other jobs are not 
stalled. 

Job Status 

T 

Displays total CPU time each job has used. The time is displayed 
as number of hours, minutes, seconds, and tenths of seconds under 
the RUN-TIME column. 

+ 

Displays the increment of CPU time each job has used since the 
display program last updated the screen. The user can return to 
total CPU time by typing T. 

% 

Displays the amount of CPU time each job has used as a percent 
of the total CPU time expended. The user can return to total or 
increment of CPU time by typing, respectively, T or +. 

J-D 

Does not display detached jobs. 

J+D 

Includes detached jobs in display. 

JD 

Displays only detached jobs. 

J-S 

Does not display sleeping jobs. 

J+S 

Includes sleeping jobs in display. 

N 

Indicates the program name in the WHAT column. 

-N 

Removes the program name from the WHAT column and replaces 
it with name of the RTS under which the job is running. 


(continued on next page) 
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Table 14-4 (Cont.): 

DISPLY Program Commands 

Command Type 

Format and Description 

Job Status (con’t) 

P 

Indicates, under the Pr column, the exact priority (modulo 8) of 
the jobs. 

-P 

Indicates, under the Pr column, the relative priority of the jobs. 
See the section "Job Status Statistics." 

W 

Indicates, under the STATE column, the last WAIT state rather 
than actual state. 

Disk Structure 

-W 

Removes the last WAIT state and indicates the actual state of 
each job. 

K 

Displays, under the SIZE column, the amount of memory occupied 
by each job. 

-K 

Displays, under the SIZE column, the amount of memoiy remain¬ 
ing for each job. 

D, Dn, -D 

Displays disk structure statistics. If n is 1, places the item first 
on the screen. A preceding minus sign removes the disk structure 
statistics from the screen. 

L, -L 

Displays, under the COMMENTS column, the logical name of 
each device. The preceding minus sign replaces logical names 
with standard PUB, PRI, NFS, or LCK notations. 

Busy Devices 

B f Bn, -B 

Displays busy device statistics. If n is 1, the program places the 
statistics first on the screen. A preceding minus sign removes 
busy device statistics from the screen. 

Free Buffer 

F, Fn, -F 

Displays free buffer statistics. If n is 1, the program places the 
statistics first on the screen. A preceding minus sign removes free 
buffer statistics from the screen. 

Message 

M, Mn, -M 

Displays message receiver statistics. If n is 1, the program places 
the statistics first on the screen. A preceding minus sign removes 
message receiver statistics from screen. 

Run-Time System 

R, Rn, -R 

Displays run-time system data. If n is 1, the program places the 
data first on the screen. A preceding minus sign removes run-time 
data from the screen. 

Resident Libraries 

H, Hu, -H 

Displays resident library data. If n is 1, the program places the 
data first on the screen. A preceding minus sign removes the 
resident library data from the screen. 
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14.7.2 Screen Layout 


The program divides the screen into four major sections: 


Header line 


Total statistics line 


Left-hand portion 
Right-hand portion 


Contains the RSTS/E version number, the name of the 
system, the current date and time of day, and the number of 
hours, minutes, and seconds since the start of timesharing 
operations (termed "up-time"). The header line appears on 
the first line of the display. 

Tells the percentage of time that is expended by users (User), 
input and output processing (I/O), and the monitor (Exec) as 
well as the amount of idle time (Idle) and lost time (Lost). 
The statistics print on the line below the header line but 
are replaced at the interval you specify by the WORKING... 
message. (The statistics are only printed if you use the SET 
SYSTEM/STATISTICS command.) 

Contains either the job status statistics or, if you use the S 
command, the memory usage status. 

Contains statistics for busy devices, the disk structure, run¬ 
time systems, message receivers, system buffers, and resident 
libraries. 


The DISPLY program prints information similar to the information SYSTAT 
includes in its status reports. The description of the major sections of the 
dynamic status report includes information about how the DISPLY program 
reports differ from those of the SYSTAT program. If you need a more complete 
description of SYSTAT, see the RSTS/E Utilities Reference Manual . 

The following example displays all four divisions. While the example does not 
represent an actual log of the DISPLY program, it does give you a picture of how 
information is displayed. When you run the program on your system, not all the 
illustrated information will fit on your terminal screen. You will often need to 
use commands described in Table 14—4 to delete reports so unseen portions of the 
display become visible. The example lets you see an entire display, unhindered by 
screen limitations (usually 24 rows). 


RSTS V10.0 NOODLE:: Status on 18-Jun-90 02:10 PM Up: 118:16:34 



58.6%User, 

15.2%I/0, 


25.6%Exec, 


.2%Idle, 

. 4%Lost 


Job Who 

Where 

What Size 

State Run-time 

Pr 


Busy 

devices 


1 

197, 1 

Det 

ERRCPY 

5 

SR 



Dev 

Job Why 

Dev Job Why 


2 

1,2 

Det 

OPSRUN 

23 

SL 



MM1 

26 Open MS0 26 Open 


3 

1/2 

Det 

EVTLOG 

18 

SL 







4 

1/2 

Det 

PBS... 

20 

SL 




Disk 

Structure 


5 

1/2 

Det 

QUMRUN 

24 

SL 


+ 

Dsk 

Open 

Free Clu Err 

Comments 

6 

1/2 

Det 

SPLIDL 

23 

SL 



DV0 

0 

23 1 0 

Pri,DLW 

7 

1/2 

Det 

BATIDL 

20 

SL 

C01 

- 

DR0 

3 

14888 8 0 

Pri,DLW 

8 

1/2 

Det 

BATIDL 

20 

SL 


- 

DUO 

134 177696 16 0 

Pub,DLW 

11 

1/2 

Det 

MAILSN 

32 

SR 



DU1 

0 194544 16 0 

Pri,R-0 

12 

194, 1 

KB47 

DCL 

1 

A C 







13 

1/2 

Det 

TWATCH 

5 

SL 


- 


Run-time systems 


14 

202, 1 

KB4 6 

DCL 

4 

A C 



...RSX OK 

16 Mon,KBM 


15 

248, 1 

KB44 

. . . EDT 

8 

KB 

.3 


DCL 

24K 

13 Tmp,KBM 


16 

248, 1 

KB45 

DCL 

4 

A C 

00 

o 

< 


RT11 

4K 

1 Tmp,KBM,CSZ 

20 

206, 1 

KB4 9 

DCL 

4 

A C 



BASIC 16K 

1 Tmp,KBM,CSZ 

22 

225, 1 

KB52 

...EDT 

8 

KB 



BP2 

IK 

0 Non-res,KBM 

24 

223, 1 

KB51 

DISPLY 

17 

RN 

.8 


FORTH 6K 

0 Tmp,KBM,NER 

29 

208, 6 

KB59 

DCL 

4 

A C 
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30 

206, 1 

KB 5 6 J4 BACKUP 

18 

RN 

1.2 K- Gen 

FIP 

Jobs 

TTY 

Err 

31 

208, 6 

KB60J4LINK 

28 

RN 

.3 187 

214 

30/45 

0 

3995 

35 

196, 1 

KB63 DCL 

4 

A C 







Message receivers 


EP.RLOG (Prv) 

1 

0 

0/40 

OPSER (Loc) 

2 

0 

0/30 

EVTLOG(Prv) 

3 

0 

0/32 

EVTLSN(Prv,Nt) 

3 

1 

0/16 

QM$CMD(Prv) 

4 

1 

0/20 

QM$SRV(Prv) 

4 

2 

0/30 

QM$URP(Loc) 

4 

3 

0/10 


Resident Libraries 


HISTOG 

36K 

0 

Prm,R/W,NER 

CSPLIB 

8K 

4 

Tmp 

EDT 

3 9K 

1 

Tmp 

RMSRES 

4K 

2 

Tmp 

DAPRES 

10K 

0 

Non-res 

BP2RES 

20K 

0 

Tmp 

B25SHR 

4K 

0 

Tmp 


14.7.3 Job Status Statistics 


The job status report displays information in eight separate columns on the 
left-hand portion of your terminal. The report is similar to the information the 
SYSTAT program prints in its display of job status. Unlike the SYSTAT program, 
the job status report does not include the name of the run-time system under 
which the job is running but does include abbreviations indicating the priority of 
the running job. The titles that the DISPLY program prints at the top of a job 
status report have the following meanings: 


Job 

Who 

Where 


What 

Size 

State 

Run-time 


Job number that the system assigns when the job starts timesharing 
activities. 

Account number under which each job runs. If the job is not logged in to 
the system, **,** appears in this column. 

Keyboard number of the job. DET appears in place of the keyboard 
number for jobs that run detached from the keyboard. The abbreviation 
KBxJy can appear for a job running on a pseudo keyboard. The value KBx 
identifies pseudo keyboard unit x, and the value Jy denotes job number y, 
under which the controlling job is running. 

Program name that the job is executing. 

Current size in K words of the job. 

Current state of the job indicated by the set of abbreviations in Table 14-5. 

Hours, minutes, seconds, and tenths of seconds of central processor unit 
(CPU) time the job has consumed. 


The job status report includes a PR column, which is not displayed by SYSTAT, 
that identifies the priority of the running job. The PR column can display the 
following abbreviations: 


If -P is in effect: 

+ 

Higher than normal priority 

- 

Lower than normal priority 

S 

Special run priority 

A 

Ctrl/C temporary priority 

K 

Keyboard delimiter temporary priority 
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If P is in effect: 

+n 

Positive priority n * 8 

0 

Zero priority 

-n 

Negative priority n * 8 

Table 14—5 contains a brief description of the abbreviations that can appear in 
the STATE column of the job status report. The following status descriptions can 
appear after one or more of the job state abbreviations in Table 14—5: 

Lck 

Job is locked in memory for the current operation. 

Nsw 

Job has requested that it not be swapped from memory and cannot 
be swapped unless it requests additional memory. 

Swi 

Job is currently being swapped into memory. 

Swo 

Job is currently being swapped out of memory. 

Xnn 

Job is swapped out and occupies slot nn in swap file X; file is 
denoted A, B, C, D to represent files 0 through 3 of the swap 
structure. 

Table 14-5: STATE Column Attributes 

Abbreviation 

Meaning 

?? 

Job state cannot be determined. 

BF 

Job is waiting for buffers (no space is available for I/O buffers). 

A C 

Job is in Ctrl/C state, awaiting keyboard monitor input. 

CR 

Job is waiting for card reader input. 

DB,DK,DL,DM, 

DR,DU,DV 

Job is waiting to perform disk I/O. 

DX 

Job is waiting for floppy diskette I/O. 

FP 

Job is waiting for file processing action by the system (opening or 
closing a file, file search). 

HB 

Job is detached and waiting to perform I/O to or from a terminal. 

KB 

Job is waiting for input from a terminal. 

LP 

Job is waiting to perform line printer output. 

MT,MM, or MS 

Job is waiting for magnetic tape I/O. 

RJ 

Job is waiting for RJ2780 I/O. 

RN 

Job is running or waiting to run. 

RS 

Job is waiting for residency. 

SL 

Job is sleeping. 

SR 

Job is sleeping and is a message receiver. 

TT 

Job is waiting to perform output to a terminal. 
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14.7.4 Busy Devices 


The busy device report lists the devices that are assigned or opened by a specific 
user. Items reported are the device specification, the job owning that device, and 
the condition of the device. The disk status information reports assigned disk 
units. The busy device report prints on the right-hand side of the screen and 
looks as follows: 

Busy Devices 

Dev Job Why Dev Job Why 
PKO 11 Open PK1 8 Open 

The DISPLY program reports the same information as SYSTAT reports in its busy 
device report, except that DISPLY prints two side-by-side reports to accommodate 
the limited screen space. Table 14-6 contains the abbreviations that can appear 
in the WHY column of the busy device report. 


Table 14-6: Busy Devices Status Abbreviations: WHY Column 


Abbreviation 

Meaning 

AS 

Device is explicitly assigned to a job. 

OPEN 

Device is open on a channel. 

DOS 

Magnetic tape is assigned with DOS labeling format. 

ANSI 

Magnetic tape is assigned with ANSI standard labeling format. 


14.7.5 Disks 

The disks report describes each disk in use on the system. The report contains 
the same information that SYSTAT/D displays. The DISPLY program prints the 
following information; however, because of screen limitations, it does not print 
column headings or as much detail as SYSTAT does: 

• Disk device specification 

• Number of open files 

• Number of free 512-byte blocks 

• Pack cluster size 

• Disk hardware error count 

• Comments on the status of the disk 

• Pack identification name or system logical names (if any) assigned for the 
devices in use on the system 

The disks report appears on the right-hand side of your terminal and looks as 
follows: 


Disk Structure 


DRO 

0 

17252 

4 

0 

Pri,DLW 

DR1 

42 

3044 

4 

2 

Pub,DLW 

DR2 

0 

12496 

4 

0 

Pri,R-0 

DR3 

5 

32144 

8 

3 

Pri,DLW 

DR4 

1 

3272 

4 

1 

Pri,DLW 

DR5 

0 

532032 

16 

6 

Pri,R-0 
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To display the pack identification names or system logical names, you must use 
the L command described in Table 14—4. This command displays the disk label 
information in place of the comments that the program normally displays. For 
example: 


Disk Structure 


DRO 

0 

17252 

4 

0 

ROGER 

DR1 

42 

3044 

4 

2 

SYS 

DR2 

0 

12496 

4 

0 

ZEBRA 

DR3 

5 

32144 

8 

3 

ABLE 

DR4 

1 

3272 

4 

1 

MIKE 

DR5 

0 

532032 

16 

6 

YOKE 


If you want to display the comments again, use the -L command. The limited size 
of the screen requires the use of the L and -L commands. 

Table 14-7 lists the abbreviations in the COMMENT column of the disks report. 

Table 14-7: Disk Status Abbreviations: COMMENT Column 


Abbreviation 

Meaning 

Pub 

Cartridge or pack is public. 

Pri 

Cartridge or pack is private. 

NFS 

Disk is open as a non-file-structured device. 

R-O 

Disk unit is read-only (write-locked) 

DLW 

Date of last write (modify), rather than date of last access, is stored 
in file accounting entries. 

Lck 

Disk is in a restricted state. 

NFF 

New files on this disk are put at the beginning of the directory. 


14.7.6 Message Receivers 

The message receivers report: 

• Provides the job name of the receiving job 

• Provides the job number of the receiving job 

• Includes the number of messages queued for the job 

• Gives the declared maximum number of messages the job can queue 

• Tells whether local and network senders are allowed 

• Indicates whether local senders must have SEND privilege 

The message receivers report appears on the right-hand portion of the screen and 
often does not appear until you delete the disk and run-time system reports with 
the -D and -R commands, respectively. A sample of the message receivers report 
is: 


Message receivers 
ERRLOG(Prv) 1 

0 

0/40 

OPSER (Loc) 

2 

0 

0/30 

QUEMAN(Loc) 

3 

0 

0/60 

LPOSPL(Prv) 

4 

0 

0/5 

BAOSPL(Prv) 

5 

0 

0/5 

BA1SPL(Prv) 

6 

0 

0/5 

EVTLSN(Prv,Nt) 

7 

0 

0/16 

EVTLOG(Prv) 

7 

1 

0/32 
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Due to limited space on the screen, some of the abbreviations are shorter than 
those printed by the /M switch of SYSTAT. The receiver report does not include 
the: 

• Receiver Identification Block (RIB) 

• Object type 

• Number of links used and the maximum links allowed. 

Table 14-8 describes the abbreviations found in the message receiver status 
report. 

Table 14-8: Message Receivers Abbreviations 

Abbreviation Meaning __ 

Loc Local senders are allowed for this receiver ID. 

Prv Local senders must have SEND privilege to send to this receiver ID. 

Nt Network senders are allowed for this receiver ID. 

IS Receiver can handle one and only one link. 

N1 Both of the above. Network senders are allowed for this receiver ID. 

Receiver can handle one and only one link. 


14.7.7 Free Buffers 

The free buffers report provides the following information: 

• Number of general small (16- word) buffers not currently in use 

• Number of FIP buffers not currently in use 

• Number of jobs currently running 

• Maximum number of jobs allowed to run 

• Number of hung terminal errors 

• Total number of errors logged on the system 

The report prints the same information the /F switch of the SYSTAT program 
produces. An example of a free buffers report is: 

Gen FIP Jobs TTY Err 
183 1 14/50 0 9 


14.7.8 Run-Time Systems 

DISPLY shows the run-time systems report on the right-hand portion of the screen. 
The report includes the same information as SYSTAT/R displays, except for: 

• The maximum size in K words that a job running under the run-time system 
can take 

• Some information in the comments column because of limited screen space 

The run-time systems report prints: 

• Name of each run-time system 

• Size of the run-time system in K words 


Miscellaneous System Management Functions 14—21 













• Number of user jobs currently executing under the control of the run-time 
system 

• Comments regarding the status of the run-time system 


A sample run-time systems report is: 


RSTS V10. 

0 ERERE 

: : 


Status on 31-Jun-90 

04:34 PM Up: 120:08 

: 06 


5.8%User, 

2.7%I/0 


.5%Exec, 91.0%ldle, .0%Lost 


Job Who 

Where 

What Size 

State 

Run-time Pr 

Busy devices 


1 

1,2 

Det 

ERRCPY 

5 

SR 

+ 

if if None * ★ ★ 


2 

1,2 

Det 

OPSRUN 

23 

SL 

.1 



3 

1,2 

Det 

EVTLOG 

18 

SL 


Disk Structure 


4 

1,2 

Det 

PBS... 

21 

SL 

Dsk < 

Open Free Clu Err 

Comm 

5 

1,2 

Det 

QUMRUN 

24 

SL 

+ DV0 

0 21 1 0 

Pri, 

6 

1,2 

Det 

SPLIDL 

23 

SL 

DR0 

3 46640 8 0 

Pri, 

7 

1,2 

Det 

BATIDL 

20 

SL 

- DUO 

116 175472 16 0 

Pub, 

8 

1,2 

Det 

BATIDL 

20 

SL 

- DU9 

0 390752 16 0 

Pri, 

9 

1,2 

Det 

BATIDL 

20 

SL 

- DU1 

0 230320 16 0 

Pri, 

10 

1,2 

Det 

MAILQ 

32 

SR 

- DU1 

0 194544 16 0 

Pri, 

11 

1,2 

Det 

MAILSN 

32 

SR 




12 

223, 1 

KB43 

DCL 

4 

A C 


Run-time systems 


13 

1,2 

Det 

TWATCH 

5 

SL 

- ...RSX 0K 13 Mon,KBM 


14 

217, 1 

KB44 

DCL 

4 

A C 

DCL 

24K 10 Tmp,KBM 


15 

236, 1 

KB53 

DCL 

1 

A C 

RT11 

4K 0 Tmp,KBM,CSZ 

16 

202, 1 

KB46 

NONAME 

2 

A C 

TECO 

10K 0 Tmp,KBM 


18 

194, 1 

KB47 

DISPLY 

17 

RN 

1.3 BAS4AL 16K 2 Non-res,KBM 


Table 14-9 contains a list and description of each abbreviation that DISPLY 
prints in the COMMENTS column. 


Table 14-9: Run-Time Systems and Resident Libraries Report Abbreviations 


Abbreviation 

Meaning 

Non-res 

Run-time system or library is nonresident. 

Loading 

Run-time system or library is being loaded into memory. 

Temp 

Run-time system or library is removed from memory when not 
being used. 

Perm 

Run-time system or library stays in memory when not being used. 

Addrtxxx 

The value of xxx denotes the starting address of the run-time 
system or library. 

[DF] KBM 

Run-time system or library can serve as a keyboard monitor. The 
optional prefix DF indicates default keyboard monitor. 

1US 

Run-time system or library can serve only one user. 

R/W 

Run-time system or library allows read/write access. 

NER 

Errors occurring within the run-time system or library are not sent 
to the system error log. 

Rem 

Run-time system or library is removed from memory as soon as all 
of its jobs switch to another run-time system or library. 

CSZ 

Proper job image size (in K words) to run a program can be com¬ 
puted as K-size=(file size+3)/4. 

EMT:yyy 

Denotes the EMT code for special EMT prefix. 
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14.7.9 Resident Libraries 


The resident libraries report includes: 

• Name of the resident library 

• Protection code of the resident library 

• Size of the resident library 

• Number of user jobs currently executing under its control 

• Comments regarding the status of the resident library 

DISPLY shows the resident libraries report on the right-hand portion of the 
screen. The report shows the same information as SYSTAT/L displays. Some 
information in the COMMENTS column may be omitted due to limited space 
on the screen. See Table 14—9 for a description of the abbreviations used in the 
COMMENTS column. 


14.7.10 Memory Status 

The S command causes the program to print a table that shows the use of each 
IK-word portion of memory. The memory status report replaces the job status 
report on the lefthand half of the screen. Use the J command to display the job 
information again. 

Type the S command to have DISPLY print the memory status report as in this 
example: 


Memory usage (Starting at OK) 


0 

MON 

MON 

MON 

MON 

MON 

MON 

MON 

8 

MON 

MON 

MON 

MON 

MON 

MON 

MON 

16 

MON 

MON 

MON 

MON 

MON 

MON 

MON 

24 

MON 

MON 

MON 

MON 

MON 

MON 

MON 

32 

MON 

MON 

MON 

MON 

MON 

MON 

MON 

40 

MON 

MON 

MON 

MON 

MON 

MON 

MON 

48 

MON 

MON 

MON 

MON 

MON 

MON 

MON 

56 

*1* 

*1* 

*1* 

* 1 * 

* 1* 

*1* 


64 

*1* 

*1* 

*1* 

*1* 

* ^ * 

*i * 

* 

72 

XBF 

XBF 

XBF 

XBF 

XBF 

XBF 

XBF 

80 

XBF 

XBF 

XBF 

XBF 

XBF 

XBF 

XBF 

88 

XBF 

XBF 

XBF 

XBF 

XBF 

XBF 

XBF 

96 

XBF 

XBF 

XBF 

XBF 

XBF 

XBF 

XBF 

104 

XBF 

XBF 

XBF 

XBF 

XBF 

XBF 

XBF 

112 

XBF 

XBF 

XBF 

XBF 

XBF 

XBF 

XBF 

120 

XBF 

XBF 

XBF 

XBF 

XBF 

XBF 

XBF 

128 

XBF 

XBF 

XBF 

XBF 

XBF 

XBF 

XBF 

136 

XBF 

XBF 

XBF 

XBF 

XBF 

XBF 

XBF 

144 

XBF 

XBF 

XBF 

XBF 

XBF 

XBF 

7 

152 

7 

7 

7 

7 

7 

7 

7 

160 

7 

7 

7 

7 

7 

7 

7 


Due to limited screen space, the program may not be able to display all memory 
status information simultaneously The Sn command lets the user determine the 
starting 8K section. The display program prints the starting section number for 
the row and eight abbreviations per row. Each of the abbreviations relates to the 
status of a IK section of memory. The number of rows the program prints and 
the extent of memory covered is limited by the terminal. The program indicates 
the starting IK section by printing a header line in the following format: 

MEMORY USAGE (STARTING AT nK) 
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Table 14—10 contains a description of the abbreviations the memory status report 
uses. 


Table 14-10: Memory Status Report Abbreviations 


Abbreviation 

Meaning 

MON 

Occupied by the RSTS/E monitor. 

*n* 

Occupied by run-time system n, where n is the position in the run¬ 
time system list. (A question mark is printed if the run-time system 
name cannot be determined.) 

-n- 

Occupied by resident library n, where n is the position in the 
resident library list. 

n 

Occupied by job number n. 

nLK 

Job number n is locked in this IK portion. 

nS 

Job number n is being swapped out of memory. 

nSI 

Job number n is being swapped into memory. 

NXM 

Memory space is nonexistent. 

END 

End of physical memory for user jobs. 

LCK 

Memory is locked. 

XBF 

Memory is reserved for the extended buffer pool (XBUF). 


14.8 Electronic Messaging Systems 

RSTS/E can tie in to electronic messaging systems. Electronic messaging 
systems, such as Telex and TWX, resemble electronic mail systems. However, the 
messages are not sent between accounts on computers, but between machines 
(computers or simply terminals). The senders and most of the receivers are 
subscribers to the electronic messaging service, which sends the messages over 
the public telephone system. 

Every subscribing machine in a messaging system has an identification. 

When the machine sends or receives messages, it sends this identification 
to the messaging service to verify its identity. Use the DCL command SET 
SYSTEM/ANSWERBACK, to store your system’s identification. For example: 

$ SET SYSTEM/ANSWERBACK="221BBAKERSTREET" 

The identification text must be no more than 24 alphanumeric characters. Most 
messaging services do not allow more than 15 characters. RSTS/E allows spaces 
and punctuation marks, but most messaging services do not. 

You can set any terminal, or any number of terminals, to receive these messages. 
Use the DCL command SET TERMINAL/ANSWERBACK/PERMANENT to 
designate a terminal. For example: 

$ SET TERMINAL KB12:/ANSWERBACK/PERMANENT 

Terminals set to ANSWERBACK can still be used as normal timesharing 
terminals. Messages are only received when logged out. 

When messages arrive, RSTS/E stores each of them in a file with a unique name 
based on the time, for example, 118432.001. The first four digits indicate the 
number of minutes since midnight (1184); the next two indicate the number 
of seconds since the beginning of the current minute (32). The number in the 
filetype gives the order in which the message was received. Thus, the second 
message to be received in the same second goes into 118432.002. 
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RSTS/E keeps all these files in the EMS$: account. You must create an account 
and assign the logical name EMS$: to it by including this DCL command in your 
[0, l]START.COM file: 

$ ASSIGN/SYSTEM dev:[p,pn] EMS$: 

You can print these files for manual distribution, or an application program can 
scan them to determine which user on the system should receive which file. 

The Unsupported Software package (UNSUPP$) contains a sample command 
procedure under the name EMS.COM. This procedure uses DECmail-11 to deliver 
electronic messages to individual users on the system. 

You can write application programs for other systems that deliver messages to 
the RSTS/E system in the same manner as an electronic messaging service. To 
use such a program, you must: 

• Have a phone line to a modem connected to the RSTS/E system 

• Have the program send Ctrl/E to the RSTS/E system 

• Know what identification to expect in response to the Ctrl/E 

• Dump an ASCII file containing the message to the RSTS/E system 


14.9 DCL Command Descriptions 

The following sections describe the DCL commands for the miscellaneous system 
functions. 
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14.9.1 LOAD/INDEX Command 


This command lets you load SATs into memory dining timesharing. By making 
SATs resident in memory, you can improve the system’s performance at the cost 
of increased memory (XBUF) usage. LOAD/INDEX requires SWCTL privilege. 


Format 

LOAD/INDEX [dev[:]] 

Command Qualifiers Defaults 

none none 

Prompts 

none 


Command Parameters 

[dev[:]] 

Specifies the disk whose SAT you want to load into memory. If you do not specify 
a device, the default is the system disk. 
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14.9.2 LOAD/OVERLAY Command 


This command lets you load monitor overlays in memory during timesharing. 
By making certain monitor functions resident in memory, you can improve 
the system’s performance at the cost of increased memory (XBUF) usage. 
LOAD/OVERLAY requires SWCFG privilege. 


Format 

LOAD/OVERLAY overlay-name[,...] 

Command Qualifiers Defaults 

/ALL none 

Prompts 

Overlay name: 


Command Parameters 

overlay-name 

Specifies the monitor overlay that you want to load into memory. The allowable 

values are: 

• ATTRIBUTE — Indicates the monitor overlay that performs file and account 
attribute read/write operations. 

• DCL — Indicates the monitor overlay that performs file operations for DCL. 

• DELETE_RENAME — Indicates the monitor overlay that performs file 
deletion and renaming. 

• DIRECTORY — Indicates the monitor overlay that performs disk file lookup 
operations. 

• FILE_UTILITY — Indicates the monitor overlay that performs the UU.FIL 
monitor directive, which is used by the COPY command. 

• SYSTEM_CALLS — Indicates the monitor overlay that performs all of the 
following monitor directives: 

— Get monitor tables (parts 1, 2, and 3) 

— Return open file information 

— Date and time conversion 

— Return job status 

• TERMINAL—Indicates the monitor overlay code that performs terminal 
characteristics SET and SHOW operations. 
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Command Qualifiers 

/ALL 

Indicates that all possible overlays should be loaded into memory. If you specify 
this qualifier, RSTS/E does not allow any overlay names. 
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14.9.3 SET DATE Command 


This command sets the RSTS/E system date to the value you specify. Optionally, 
you can specify a new value for the system time. You can specify relative values 
for the date or time. See the previous section Changing System Date and Time 
for an explanation of relative dates and times. SET DATE requires DATES 
privilege. 


Format 

SET DATE date[:time] 

Command Qualifiers 
none 

Prompts 

Date: 


Command Parameters 

date 

Specifies the system date. Insert a space between the date field and the DCL 
command. You can specify a relative date with the keyword DAYS. 

[:time] 

Specifies the system time. You can specify a relative time with the keywords; 
HOURS and MINUTES. Insert a colon (:) between the date and time fields. 

NOTE 

When you specify the AM/PM suffix, there is no space between the 
minutes and the suffix. For example: 

$ SET DATE 5-JAN-90:1:30PM 
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14.9.4 SET SYSTEM Command 

This command sets the default system characteristics. You need one or more 
privileges to use this command (see the discussion for each command qualifier). 

Format 

SET SYSTEM 



Command Qualifiers 

Defaults 


/ANSWERBACK="identification" 

none 


/DATE_FORMAT=format 

See Discussion 


/DENSITY=default 

See Discussion 


/DYNAMIC_REGION_LIMIT=n 

none 


/EMT_LOGGING=(emt1 ,emt2[,...]) 

none 


/[NO]FMS 

none 


/HANGUP={DELAYED | IMMEDIATE} 

/HANGUP=DELAYED 


/HOLD 

none 


/LABEL=default 

See Discussion 


/[NOJLAT 

none 


/[NO]LOG 

/LOG 


/[NO]LOGINS[=n] 

/LOGINS=job-max 


/MONITOR_NAME=name 

none 


/NAME="installation name" 

none 


/[NO]PASSWORD_PROMPT[=(type[,...])] 

See Discussion 


/POWERFAIL_DELAY=n 

none 


/PSEUDO_KEYBOARDS=n 

/PSEUDO_KEYBOARDS=4 


/RELEASE 

none 


/[NO]STATISTICS[=RESET] 

/NOSTATISTICS 


/SWAP_MAXIMUM=n 

none 


/TIME_FORMAT=format 

Prompts 

None 

See Discussion 


Command Qualifiers 

/ANSWERBACK= M identification M 

Sets the system identification for electronic messaging systems such as Telex or 
TWX. The exact format of the identification depends on the messaging system 
you subscribe to. RSTS/E requires that it have no more than 24 characters, all 
alphanumeric. Most messaging services do not allow identifications longer than 
15 characters, with spaces or punctuation marks. You need SWCTL privilege to 
use this qualifier. 
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/DATE_FORMAT=format 

Sets the default date format: 

• ALPHABETIC — Sets the default date format to alphabetic (DD-MMM-YY) 

• NUMERIC — Sets the default date format to numeric (YYMM.DD) 

You need SWCFG privilege to specify this qualifier. 

/DENSITY=default 

Specifies the magnetic tape default density; n can be any number between 2 and 
32,766, or the keywords MINIMUM or MAXIMUM may be used. Generally, the 
available tape drives support 800, 1600, 6250, 6667, 8000, or 10,000 bpi densities. 
If the system default density is less than the drive’s lowest possible density, then 
RSTS/E uses the drive’s lowest possible density. 

If you do not specify a density for the INITIALIZE, or MOUNT commands, the 
system chooses the nearest legal density for that tape drive that is not greater 
than the system default density. If you specify MINIMUM or MAXIMUM for 
the default density, the system chooses the tape drive’s minimum or maximum 
density for the INITIALIZE, or MOUNT commands. 

You need HWCFG privilege to use this qualifier. 

/DYNAMIC_REGION_LIMIT=n 

Sets the amount of memory available to use as dynamic regions for those users 
and applications without INSTAL privilege. Enter a number n for nK words. 

The available memory must be shared among all the users and applications on 
the system, so there may be less than nK available at any given time. You need 
SWCFG privilege to use this qualifier. 

/EMT_LOGGING=(emt1 ,emt2[,...]) 

Enables and disables logging for the particular EMT information you want. For 
example: 

$ SET SYSTEM/EMT_LOGGING=(NOCRE,NODLN,ASS,DEA) 

This command disables logging for creating files (CRE) and deleting files (DLN), 
while, at the same time, enabling logging for assigning devices (ASS) and 
deassigning devices (DEA). See the section Loggable EMTs Enabled or Disabled 
by SET SYSTEM earlier in this chapter. You need SWCTL privilege to use the 
/EMTJLOGGING qualifier on the SET SYSTEM command. 

/[NO]FMS 

Enables FMS the next time the system restarts. The /NOFMS qualifier disables 
FMS. You need SWCFG privilege to use this qualifier. 

/HANGUP={DELAYED | IMMEDIATE} 

Sets whether or not the system delays hanging up dialup lines when carrier is 
dropped. The default is DELAYED, which means the system waits approximately 
five seconds before hanging up a dialup line. Setting IMMEDIATE means the 
system hangs up a dialup line as soon as the carrier is dropped. IMMEDIATE is 
mainly used for European dial-up lines. You need SWCFG privilege to use this 
qualifier. 

/HOLD 

Stops execution of all jobs except the one issuing the command. You need HWCTL 
privilege to use this qualifier. 
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/LABEL=default 

Sets the default magnetic tape label: 

• ANSI — Sets the default magnetic tape label to ANSI 

• DOS — Sets the default magnetic tape label to DOS 

You need SWCFG privilege to use this qualifier. 

/[NO]LAT 

Enables LAT support the next time the system restarts. The /NOLAT qualifier 
disables LAT support, saving 2K words of memory. You need SWCFG privilege to 
use this qualifier. 

/[NO]LOG 

Use with the /EMT_LOGGING qualifier. Controls whether or not a confirmation 
message displays when you enable or disable EMT logging. The default is /LOG 
(confirmation displays). 

/[NO]LOGINS[=n] 

Specifies the maximum number of users who can log in to the system at one time. 
SET SYSTEM/LOGINS=n sets the number of jobs that can be logged in to the 
system at one time to n. The default for n is JOB MAX. Specify /NOLOGINS 
if you want to prevent other users from logging in to the system. This sets the 
number of logins to one. You need SWCTL privilege to use this qualifier. 

/MONITOR_NAME=name 

Sets the monitor name to the name you specify. The monitor name is a file name 
and has the usual file name format. The new monitor must reside in _SY0:[0,1] 
and have a file type of .SIL. The system uses the new monitor at the next 
automatic restart, or as the default name the next time you start timesharing. 
You need SYSIO privilege to use this qualifier. 

/NAME="installation name" 

Sets the system name to the name you specify. You can specify up to 15 charac¬ 
ters in the name. You need SWCFG privilege to use this qualifier. 

/[NO]PASSWORD_PROMPT[=(type[,...])] 

Specifies the types of users that must enter the system password. If you do 
not specify any types, all users must enter the password. If you want to limit 
prompting to remote users, use the types NETWORK and DIALUP. You need 
WACNT privilege to use this qualifier. 

/POWERFAIL_DELAY=n 

Sets the power fail delay to n. When a power failure occurs, the system waits n 
seconds before rebooting the system. The value of n can range from 1 to 300. You 
need SWCFG privilege to use this qualifier. 

/PSEUDO_KEYBOARDS=n 

Specifies the maximum number, n, of static pseudo keyboards available on the 
system the next time the system restarts. This n can range from 1 to 127. The 
default is 4. You need SWCFG privilege to use this qualifier. 

/RELEASE 

Resumes execution of all jobs on the system. You need HWCTL privilege to use 
this qualifier. 
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/[NO]STATISTICS[=RESET] 

Turns monitor statistics on and off. The system default is statistics turned 
off. Once statistics have been turned on, the SET SYSTEM/NOSTATISTICS 
command freezes statistics. The SET SYSTEM/STATISTICS command unfreezes 
them. SET SYSTEM/STATISTICS=RESET resets the statistics counters to zero. 
You need SWCTL privilege to use the qualifier. 

/S WAP_M AXIM U M= n 

Sets the maximum size of the swap file to the value you specify. Enter a number 
n between 34 and 66 for a size of 34K to 66K words. The system uses the new 
maximum size at the next restart. You need TUNE privilege to use this qualifier. 

/TIME_FORMAT=format 

Sets the default time format: 

• AM_PM — Sets the default time format to AM/PM time (1:30PM) 

• 24_HOUR - Sets the default time format to 24-hour time (13:30) 

You need SWCFG privilege to use this qualifier. 
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14.9.5 SET TIME Command 


This command sets the RSTS/E 24-hour clock to the value you specify. Optionally, 
you can set the system date to the value you specify You can specify relative 
values for the date or time. See the previous section Changing System Date and 
Time for an explanation of relative dates and times. SET TIME requires DATES 
privilege. 


Format 

SET TIME [date:]time 

Command Qualifiers 
none 

Prompts 

Time: 


Command Parameters 

[date:] 

Specifies the system date. If you specify this optional field, insert a space between 
the DCL command and the date field and insert a colon between the date and 
time fields. You can specify a relative date with the keyword DAYS. 

time 

Specifies the system time. You can specify a relative time with the keywords; 
HOURS and MINUTES. 

NOTE 

When you specify the AM/PM suffix, there is no space between the 
minutes and the suffix. For example: 

SET TIME 1:30PM 
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14.9.6 SHOW SYSTEM Command 


This command displays the system default characteristics as follows: 


System name: 

RSTS V10.0-L ] 

Currently installed Monitor: 

V10LAT 

Swap Maximum: 

66K 

Date format: 

Alphabetic 

Time format: 

AM PM 

Magtape label default: 

DOS 

Magtape density default: 

800 BPI 

Power fail restart delay: 

300 seconds 

Dynamic Region Limit: 

OK words 

Hangup: 

Delayed 

Monitor Statistics: 

Enabled 

Job limit: 

45 

Current jobs: 

37 

Password Prompting: 

All users 

Last System Password change: 

02-Feb-90 at ( 

LAT Software: 

Installed 

FMS Software: 

Not Installed 

Current Pseudo keyboards: 

10 

Answerback message: 

None 


Upon reboot: Not installed 


SHOW SYSTEM does not require any privileges. 


Format 

Defaults 
none 

your terminal 

Prompts 
none 


SHOW SYSTEM 

Command Qualifiers 
/EMT_LOGGING 
/[NO]OUTPUT[=filespec] 


Command Qualifiers 
/EMT_LOGGING 

Displays the current logging status of all EMTs. You need no special privilege to 
use this qualifier. 

/[NO]OUTPUT[=filespec] 

Writes the information to the specified file. If you specify /NOOUTPUT, the 
information is suppressed and not displayed. If the optional filespec argument is 
omitted, the output displays on the terminal. 
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14.9.7 UNLOAD/INDEX Command 


This command lets you unload SATs that were loaded into memory using the 
LOAD/INDEX command. UNLOAD/INDEX requires SWCTL privilege. 


Format 

UNLOAD/INDEX [dev[:]] 

Command Qualifiers 
none 

Prompts 

none 


Command Parameters 
dev[:] 

Specifies the disk whose SAT you want to unload from memory. If you do not 
specify a device, the default is the system disk. 
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14.9.8 UNLOAD/OVERLAY Command 

This command lets you unload monitor overlays that were loaded into memory 
with the LOAD/OVERLAY command. UNLOAD/OVERLAY requires SWCFG 
privilege. 

Format 

UNLOAD/OVERLAY 

o verlay-name[,...] 


Command Qualifiers 

Defaults 


/ALL 

none 


Prompts 

Overlay name: 



Command Parameters 

overlay-name 

Specifies the monitor overlay that you want to unload from memory. The 
allowable values are: 

• ATTRIBUTE — Indicates the monitor overlay that performs file and account 
attribute read/write operations. 

• DCL — Indicates the monitor overlay that performs file-related operations for 
DCL. 

• DELETE_RENAME — Indicates the monitor overlay that performs file 
deletion and renaming. 

• DIRECTORY — Indicates the monitor overlay that performs disk file lookup 
operations. 

• FILE_UTILITY — Indicates the monitor overlay that improves file perfor¬ 
mance. 

• SYSTEM_CALLS — Indicates the monitor overlay that performs all of the 
following monitor directives: 

— Get monitor tables (parts 1, 2, and 3) 

— Return open file information 

— Date and time conversion 

— Return job status 

• TERMINAL — Indicates the monitor overlay code that performs terminal 
characteristics SET and SHOW operations. 
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Command Qualifiers 

/ALL 

Indicates that all possible overlays should be unloaded from memory. If you 
specify this qualifier, RSTS/E does not allow any overlay names. 
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Chapter 15 

Managing Disks and Tapes 


This chapter describes the DCL commands that you use to manage RSTS/E 
disks and tapes. First, Table 15-1 lists and briefly describes the DCL commands 
available to you. Then the chapter provides background information about 
disk and tape handling on RSTS/E. Finally, the chapter lists each command 
alphabetically and explains it in more detail. 

Some functions of INITIALIZE, MOUNT, and DISMOUNT require privilege. 
This manual describes all the functions. The RSTS/E System User's Guide also 
describes those functions that do not require any privileges. 


Table 15-1: DCL Commands for Disk and Tape Handling 


Command 

Meaning 

INITIALIZE 

Initializes a disk or magnetic tape. Use this command to prepare 
the medium for writing new files. 

MOUNT 

Logically mounts a disk or magnetic tape. Use this command after 
you physically mount the disk or tape on the device. 

DISMOUNT 

Logically dismounts a disk or magnetic tape. Use this command 
before you physically dismount the disk or tape from the device. 


15.1 Working with Disks and Tapes 

The system manager or operator is often responsible for mounting and dis¬ 
mounting disk packs and magnetic tapes. Indeed, only a user with MOUNT 
privilege can load disks on the public structure. Thus, you need to be familiar 
with commands that prepare tapes and disks for use: INITIALIZE, MOUNT, and 
DISMOUNT. 


15.1.1 Initializing Disks and Tapes 

Initializing a disk or tape makes it "like new." You should consider initializing if 

you have: 

• An old disk or tape to recycle; you initialize it to eliminate any existing files 
that it contains. 

• A new disk or tape; you initialize it to perform all the necessary actions that 
make it usable on your system. (The INITIALIZE command descriptions 
explain these necessary actions.) 
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Certain disks require formatting before they are initialized. Formatting writes 
timing and sense marks onto the disk and destroys any information that the 
disk contains. You format disks using the DSKINT option of INIT.SYS; for a 
description see the RSTS/E Installation and Update Guide. 

You must shut the system down to format the following disks before using them 
on a RSTS/E system: RK05, RK05F, RP02, RP03, and RX33. 

NOTE 

These disks need to be formatted only once. All other disks have been 
formatted at the factory and need not be formatted again. 

The DSKINT option also creates a RSTS/E file structure on the disk. You can 
later use the DCL INITIALIZE command to clear the disk of files and recreate 
the RSTS/E file structure. 

The INITIALIZE command: 

• Has different qualifiers for disk initialization from those for tape initializa¬ 
tion. 

• Requires WRTNFS privilege when used for disks. 

The section "INITIALIZE Command for Tapes" later in this chapter describes 
tape initialization. See the RSTS/E System User's Guide for nonprivileged uses 
of the INITIALIZE command. 


15.1.2 Mounting and Dismounting Tapes and Disks 

Whenever you want to use a different tape or disk from that which is mounted, 
you must logically dismount the current disk or tape (using the DISMOUNT 
command), and physically remove the disk or tape from the drive. Then you 
physically mount the new disk or tape on the drive and place the drive on line. 

After physically mounting and activating the medium, you must logically mount 
the new disk or tape (using the MOUNT command). This allocates the drive for 
appropriate use. For example, a tape drive is allocated for use only through your 
account. A disk drive with a pack initialized and mounted as public becomes part 
of the public structure. It can be used by anybody on the system. 

The MOUNT command prepares an initialized disk or tape for processing by 
system commands or user programs. The DISMOUNT command releases a disk 
or tape that was previously accessed with a MOUNT command. Both MOUNT 
and DISMOUNT have different qualifiers when used with disks or tapes. 
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15.2 DCL Command Descriptions 

The following sections describe the DCL commands for managing RSTS/E disks 
and tapes. See Chapter 11 for descriptions of the DCL commands for managing a 
virtual disk. 


15.2.1 DISMOUNT Command for Disks 


This command for disks releases a disk previously accessed with a MOUNT 
command. Issue this command before taking the drive off line or before physi¬ 
cally dismounting the disk. You can dismount any disk with MOUNT privilege. 
Without MOUNT privilege, you can only dismount a disk mounted /NOSHARE 
for your job. 

The DISMOUNT command deallocates the disk if it was allocated to you. You 
cannot DISMOUNT a device if there are open files on it. If you try, the system 
displays the error message: 

?Account or device in use 


Format 

DISMOUNT disk-device-name[:] [pack-id] 

Command Qualifiers Defaults 

/PUBLIC none 

Prompts 

Device: device-name[:] 


Command Parameters 

disk-device-name[:] 

The physical or logical name of the disk unit containing the pack to be dis¬ 
mounted. If you do not specify a unit number, the following error message 
appears: 

?Unit number needed 

[pack-id] 

The pack-id specified when the disk was initialized and mounted. The pack-id is 
deassigned as a systemwide logical. The pack-id is optional. 

Command Qualifiers 

/PUBLIC 

You need MOUNT privilege to dismount a public disk. (The disk must have been 
mounted and initialized as public.) 
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If you do not specify /PUBLIC, the system assumes that the disk was mounted as 
private. If you try to dismount a public disk without the /PUBLIC qualifier, you 
get the error message: 

?Disk is mounted public 

If you try to dismount a disk by using the /PUBLIC qualifier and the disk was 
mounted as private, you get the error message: 

?Disk is mounted private 

If you do not have MOUNT privilege you can only dismount private disks if they 
were mounted /NOSHARE. If you try to dismount a public disk, you get the error 
message: 

?You must have MOUNT privilege to dismount a public disk 

If the disk was mounted with the /NOSHARE qualifier, and any unprivileged 
job except the one to which the disk is assigned attempts to dismount it, the 
following error message appears: 

?Account or device in use 
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15.2.2 DISMOUNT Command for Tapes 


This command for tapes releases a tape previously accessed with a MOUNT 
command. Issue this command before taking the drive offline or before physically 
dismounting the tape. The DISMOUNT command deallocates the tape drive if it 
was allocated to you. You cannot DISMOUNT a tape if there are open files on it. 
Any attempt to do so returns the error message: 

?Account or device in use 

When used for tapes, DISMOUNT does not require any privileges. 


Format 

DISMOUNT tape-device-name[:] [label] 

Command Qualifiers Defaults 

/[NOJUNLOAD /UNLOAD 

Prompts 

Device: device-name[:] 


Command Parameters 

tape-device-name[:] 

Specifies the physical or logical name of the drive on which the tape is to be 
dismounted. If you do not specify a unit number with a physical device name, the 
default is unit 0. 

label 

Specifies the label on an ANSI tape. Note that it is not necessary to specify a 
label with the DISMOUNT command. However, if you are using a hard-copy 
terminal, you can specify a label to keep a log of the tape being dismounted. The 
label you specify is ignored; it is not checked against the label on the tape. 

Command Qualifiers 

/[NOJUNLOAD 

Specifies whether to unload the tape from the drive. Once a tape is unloaded, 
it must be manually loaded before it can be mounted again. The default is 
/UNLOAD. 
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15.2.3 INITIALIZE Command for Disks 


This command creates a RSTS/E file structure on a disk; that is, it prepares a 
disk so files can be written to it and read from it. (Be aware that INITIALIZE 
overwrites any data previously written to the disk unless you specify the 
/NOEXERCISE/NOERASE qualifiers.) 

In creating a RSTS/E file structure for the disk, INITIALIZE writes several 
structures to the disk. For example, INITIALIZE creates a User File Directory 
(UFD) for account [0,1] that contains entries for the files SATT.SYS (the storage 
allocation table) and BADB.SYS (the bad block file). INITIALIZE also set the 
IGNORE file attribute for BADB.SYS and SATT.SYS so these files are excluded 
from backup operations. 

NOTE 

When you issue the INITIALIZE command, the disk should only be 
physically mounted in the drive; it should not be logically mounted. 

You must create DVO: first. 

When used for disks, INITIALIZE requires WRTNFS, RDNFS, and WREAD 
privileges. 


Format 


INITIALIZE disk-device-name[:] pack-id 


Command Qualifiers Defaults 

/CLUSTER_SIZE=n n=device cluster size 

/DATE={ACCESSED | MODIFIED}/DATE=MODIFIED 


/[NO]ERASE 

/[NO]EXERCISE=n 

/INDEX=position 

/MFD_CLUSTER_SIZE=n 

/NEW_FILES=[{FIRST | LAST}] 

/PRIVATE 

/PUBLIC 

/[NOJQUERY 

/[NOJRETAIN 

/[NO]WRITE 


/ERASE 

/EXERCISE=FULL 

/INDEX=MIDDLE 

/MFD_CLUSTER_SIZE=16 

/NEW_FILES=LAST 

/PRIVATE 

/PRIVATE 

/QUERY 

/RETAIN 

/WRITE 


Prompts 

Device: 

Pack-id: 
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Command Parameters 


disk-device-name[:] 

Specifies the name of the drive on which the disk is physically mounted. 

pack-id 

One to six alphanumeric characters to be used when logically mounting the 
disk. By default, RSTS/E uses this pack-id as a systemwide logical name for the 
mounted disk. 

Command Qualifiers 

/CLUSTER_SIZE=n 

Declares the pack cluster size, which is the minimum allocation unit, in 512-byte 
blocks, for the disk. All files written to this disk use multiples of n blocks, where 
n is the pack cluster size. 

In general, the cluster size specified (n) must be a power of 2 (1, 2, 4, 8, 16, 32, 
64), equal to or greater than the device cluster size, but not greater than 64. If 
you do not specify a cluster size, RSTS/E assumes the device cluster size. 

The /CLUSTER_SIZE=n option affects performance. In general, a large pack 
cluster size speeds disk I/O operations, but wastes disk space. For example, 
if you declare /CLUSTER_SIZE=16 for a disk, a file consisting of 8193 bytes 
(16 512-byte blocks plus one byte) requires 2 pack clusters, or 32 blocks. A 
/CLUSTERESIZE=8 for the same file would require three clusters, or 24 blocks, of 
disk storage. 

Table 15-2 lists the device cluster sizes for the disks that RSTS/E supports. 


Table 15-2: Disk Size and Ciuster Size 


Disk 

Type 

Minimum 

Device Cluster 
Size 

Acceptable Pack 
Cluster Size 
(/CLU STERJ3IZE) 

Total Device 

Size 1 (Blocks) 

RX50 

1 

1, 2, 4, 8, 16, 32, 64 

800 

RX33 

1 

1, 2, 4, 8, 16, 32, 64 

2400 

RK05 

1 

1, 2, 4, 8, 16, 32, 64 

4800 

RK05F 

1 

1, 2, 4, 8, 16, 32, 64 

4800 2 

RL01 

1 

1, 2, 4, 8, 16, 32, 64 

10220 

RL02 

1 

1, 2, 4, 8, 16, 32, 64 

20460 

RD51 

1 

1, 2, 4, 8, 16, 32, 64 

21600 

RK06 

1 

1, 2, 4, 8, 16, 32, 64 

27104 

RD31 

1 

1, 2, 4, 8, 16, 32, 64 

41559 

RC25 

1 

1, 2, 4, 8, 16, 32, 64 

50902 2 

RK07 

1 

1, 2, 4, 8, 16, 32, 64 

53768 

RD52 

1 

1, 2, 4, 8, 16, 32, 64 

60479 

RD32 

2 

2, 4, 8, 16, 32, 64 

83204 

RM02 

4 

4, 8, 16, 32, 64 

131648 

RM03 

4 

4, 8, 16, 32, 64 

131648 

1 Size when disk is initialized at lowest 
2 For each unit; 2 units per drive 

; acceptable cluster size 



(continued on next page) 
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Table 15-2 (Cont.): Disk Size and Cluster Size 


Disk 

Type 

Minimum 

Device Cluster 
Size 

Acceptable Pack 
Cluster Size 
(/CLU STER_SIZE) 

Total Device 

Size 1 (Blocks) 

RD53 

4 

4, 8, 16, 32, 64 

138668 

RP04 

4 

4, 8, 16, 32, 64 

171796 

RP05 

4 

4, 8, 16, 32, 64 

171796 

RA80 

4 

4, 8, 16, 32, 64 

237208 

RM80 

4 

4, 8, 16, 32, 64 

242575 

RD54 

8 

8, 16, 32, 64 

311200 

RP06 

8 

8, 16, 32, 64 

340664 

RA60 

8 

8, 16, 32, 64 

400175 

RM05 

8 

8, 16, 32, 64 

500352 

RA70 

16 

16, 32, 64 

547040 

RA81 

16 

16, 32, 64 

888012 

RA82 

32 

32, 64 

1216640 

RA90 

64 

64 

2376128 

1 Size when disk is initialized at lowest 

; acceptable cluster size 



/DATE={ACCESSED | MODIFIED} 

Lets you specify whether to record a file's date of last access (=ACCESSED) or of 
last modification (=MODIFIED). The default is /DATE=MODIFIED. 

/[ NOJERASE 

Indicates whether the data on the specified disk is erased. The /NOERASE 
qualifier applies only if you specify /NOEXERCISE. The default is /ERASE. 

NOTE 

Using /NOERASE may cause sensitive data to remain on the disk. If 
the disk contained files marked as "erase on delete" (protection code of 
128 or higher), you should not use /NOERASE unless you are sure that 
no security problems will result. 

/[NO]EXERCISE=n 

Controls whether to check for bad blocks by "exercising" the disk. This means 
that the number of patterns you select (n) are written to the disk, and then 
each block is read to make sure that the patterns were written correctly. If the 
patterns read do not match the patterns written, RSTS/E assumes the block is 
bad. RSTS/E adds any bad blocks found to the "bad block" file (BADB.SYS in 
account [0,1] on the disk). RSTS/E does not store data in any blocks allocated to 
the BADB.SYS file. 
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You can have the INITIALIZE command run from zero to three patterns by 
specifying 0, 1, 2, or 3 for n. Each pattern consists of three octal words; the 
pattern used for each of these numbers is: 


Pattern Three Octal Words 

1 155555 133333 066666 

2 133333 066666 155555 

3 066666 155555 133333 


For example, /EXERCISE=2 causes pattern 1 to be written to and read from the 
disk, followed by pattern 2 being written to and read from the disk. 

You can also select the default, /EXERCISE=FULL, which uses all three patterns, 
one at a time. That is, each block is written to and read from the disk three 
times, each time with a different pattern. Using the FULL argument increases 
the probability that all bad blocks are found, and decreases the probability 
that you will lose information later by writing into a bad block. (Note that 
/EXERCISE=FULL is equivalent to /EXERCISE=3.) 

The /NOEXERCISE qualifier indicates that you do not want to check for bad 
blocks. For example, if you previously initialized the disk and feel that the cur¬ 
rent bad block file is accurate, you can save time by specifying the /NOEXERCISE 
qualifier. This still writes one pattern all over the disk unless you specify 
/NOERASE, but it does not read it back in. (Note that /NOEXERCISE is 
equivalent to /EXERCISE=0.) 

/IN DEX=posit ion 

Positions the SATT.SYS file on the disk. SATT.SYS is the storage allocation table 
created in account [0,1] during initialization. 

The position argument can be: 

BEGINNING Puts SATT.SYS at the beginning of the disk to avoid fragmenting 

the disk. That way, more contiguous space is available to store 
other files on the disk. This is the default position for SATT.SYS for 
disks of 4500 blocks or less if you do not specify the /INDEX option. 

MIDDLE Puts SATT.SYS in the middle of the disk. For moving-head disks, it 

helps to locate SATT.SYS near the middle of the disk, which reduces 
average seek times for the disk heads. This is the default position 
for disks of more than 4500 blocks if you do not specify the /INDEX 
option. 

n Puts SATT.SYS at device cluster number n, where n can range from 

1 to the total device size divided by the device cluster size. See 
Table 15-2 for these values. 

/MFD_CLUSTER_SIZE=n 

Declares the minimum allocation unit, in 512-byte blocks, for the Master File 
Directory (MFD). The MFD is a special "catalog” structure that RSTS/E creates 
during disk initialization. The INITIALIZE command puts the MFD at the 
beginning for disks of 4500 blocks or less, or at the middle for disks of more than 
4500 blocks. 

Along with other key structures, RSTS/E updates the MFD each time users add 
or delete accounts and files on the disk. Because RSTS/E must access the MFD 
frequently, you increase performance when the MFD cluster size is large. On the 
other hand, a small MFD cluster size can save some disk space. 
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The MFD cluster size (n) can be 4, 8, or 16; it must be greater than or equal to 
the value entered for the CLUSTERJ3IZE qualifier, unless the CLUSTER_SIZE 
is 32 or 64; in that case, the MFD cluster size remains 16. The default is /MFD_ 
CLUSTERJ3IZE=16. 

/NEW_FILES=[{FIRST | LAST}] 

Indicates whether files stored on the disk should be placed at beginning of the ac¬ 
count (/NEW_FILES=FIRST) or at the end of the account (/NEW_FILES=LAST). 
The default is /NEW_FILES=LAST. 

/PRIVATE 

Allows only users who have accounts on a disk to access it. If you do not specify 
/PUBLIC or /PRIVATE, then RSTS/E assumes /PRIVATE. 

You can create a system disk by initializing the disk as /PRIVATE and then using 
the CREATE/ACCOUNT command to create and position accounts [1,1] and [1,2]. 
In this case, note that you must transfer files to the disk and use the HOOK 
utility to make it a RSTS/E system disk. 

/PUBLIC 

Allows anyone with an account on the system to access the disk. 

You can use /PUBLIC to identify any disk on the system as public, except the 
system disk. When the disk is mounted, it is considered part of the public 
structure. You need MOUNT privilege to mount a public disk. After you mount 
it, the disk is a logical extension of the system disk; thus, any user can create 
files on it. 

In general, Digital recommends against using /PUBLIC, because it can degrade 
performance over time. Consider the following points if you decide to select 
/PUBLIC for disks on your system: 

• If your system disk is nearly full, and you want to dedicate one or more 
additional disks to general file storage, you might add public disks to your 
system. Users are not generally aware of whether their files are on the 
system disk or a public disk. 

• A public disk is an extension of the system disk; therefore, it should always 
remain mounted during timesharing. In addition, you must remount it every 
time you restart the system. If you dismount the disk during timesharing, 
some users’ files will mysteriously (to them) disappear. Dismounting a public 
disk causes disruption unless you transfer all of the files on the disk to the 
system disk or to some other public disk. 

• Before adding a public disk to your system, consider the alternative of adding 
a private disk for use by specific users. Digital recommends this alternative 
because it yields significantly better system performance. However, this 
means that you must create accounts explicitly on the private disk. In 
addition, users who have accounts on the disk must refer explicitly to that 
disk in file specifications. 

Because of these considerations, the system provides several safety checks on 
initializing and mounting a public disk. First, you must have MOUNT privilege 
to do so. Second, you must specify /PUBLIC two times: when you initialize the 
disk, and when you mount the disk. Third, if you INITIALIZE the virtual disk as 
/PUBLIC (not recommended), you must still specify when you want a file placed 
on DVO:. The system never puts files on DVO: automatically. The default is 
/PRIVATE. 
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/[NO]QUERY 

When you use the /QUERY qualifier, INITIALIZE displays the characteristics of 
a disk you have selected that already has a RSTS/E file structure, and asks if you 
still want to initialize the disk. 

Thus, /QUERY lets you verify that you are initializing the disk you intended, 
thereby keeping you from accidentally wiping out the wrong disk. If you specify 
/NOQUERY, INITIALIZE simply displays the characteristics of the disk before 
overwriting its contents. The default is /QUERY. 

The display of disk characteristics is similar to: 

This disk pack appears to be a RSTS/E formatted 
disk with the following characteristics: 

Pack ID : THELMA 

Pack Cluster Size : 4 

Pack is currently : Private, 

Level 1.2 

Proceed (Y or N)? 

You must respond to the prompt with YES or NO, or some abbreviation of these. 
NO cancels the initialization; YES requests that it proceeds. There is no default 
response to the prompt. 

/[ NOJRETAIN 

Controls whether to use a previously initialized disk's bad block file. A disk that 
has not been previously initialized has no bad block file. In this case, /RETAIN 
and /NORETAIN are meaningless, and are ignored if specified. /RETAIN is the 
default on a previously initialized disk. 

If you use both the /RETAIN and /EXERCISE qualifiers, the INITIALIZE 
command keeps the old bad block file and adds any additional bad blocks it finds 
while it is checking the disk for bad blocks. 

If you specify /NOEXERCISE, then you should use /RETAIN. Because 
/NOEXERCISE does not exercise the disk for bad blocks, you should use /RETAIN 
to keep the existing bad block information. 

The /NORETAIN qualifier is useful if problems with a disk drive have been 
causing apparent bad blocks on a disk. After you learn that the problem is with 
the drive, you can recover space on the disk by using /NORETAIN. 

/[NO]WRITE 

Determines whether the disk should default to read-only (/NOWRITE) or 
read/write (/WRITE) access when it is mounted. This is useful when you initialize 
a disk that is usually mounted read-only. The default is /WRITE. 

When mounting a disk, you can override the read-only access by specifying the 
/WRITE qualifier with the MOUNT command. 
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15.2.4 INITIALIZE Command for Tapes 


This command for tapes prepares a new tape or recycles a used tape that contains 
no useful files. The INITIALIZE command for tapes makes any existing data on 
the tape unavailable to file-structured access. For ANSI tapes, it also writes a 
label that RSTS/E uses to identify the tape in a MOUNT command (ANSI tapes 
require a label). INITIALIZE allocates the tape drive if it is not already allocated. 

When used for tapes, INITIALIZE does not require any special privilege unless 
the device is restricted. If so, DEVICE privilege is required. 


Format 


INITIALIZE tape-device-name[:] [label] 


Command Qualifiers 
/DENSITY=n 
/FORMAT={ANSI | DOS} 


Defaults 

See Discussion 
See Discussion 


Prompts 

Device: magtape[:] 
Label: label (if ANSI) 
Proceed (Y or N)? 


Command Parameters 

tape-device-name[:] 

Specifies the name of the drive on which the tape is physically mounted. 

[label] 

Specifies the identification label to be encoded on the tape. The label can consist 
of a maximum of six alphanumeric characters. 

An ANSI-format tape requires a label; RSTS/E prompts you for a label if you do 
not specify one. RSTS/E checks this label against the label you specify when you 
later use the MOUNT command (see the section "MOUNT Command for Tapes"). 

DOS tapes do not allow labels: RSTS/E ignores any label you specify for them 
and displays a warning message. 

Command Qualifiers 

/DENSITY=n 

Specifies the density in bits per inch (bpi). The argument can be any number 
between 2 and 32766, or the keywords MINIMUM or MAXIMUM can be used. 
Generally, available tape drives support 800, 1600, 6250, 6667, 8000, or 10000 
bpi. 
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If you specify MINIMUM or MAXIMUM, the system checks the tape drive and 
sets the density to the minimum or maximum the drive supports. If you specify a 
density that the tape drive does not support, RSTS/E displays an error message 
and aborts the command. If you do not specify a density, the default is the system 
default density. 

/FORMAT={ANSI | DOS} 

Specifies the tape format. If you do not specify a format, the system uses the 
current system default (SHOW SYSTEM command displays the current system 
defaults). You can change the default format using the DCL command, SET 
SYSTEM/LABEL (see Chapter 14). As mentioned earlier, ANSI format requires a 
label; DOS format ignores any label specified. 
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15.2.5 MOUNT Command for Disks 


This command prepares an initialized disk for processing under timesharing. Tb 
mount a disk, you must: 

1. Physically mount the disk on a device drive. 

2. Put the drive on line. 

3. Use the MOUNT command to logically mount the disk. 

You need the MOUNT privilege to mount a disk that has been initialized as 
public. For users with MOUNT privilege, the MOUNT command rebuilds a 
dirty disk — one that has been physically dismounted (removed from the drive) 
or taken off line without being logically dismounted first with the DISMOUNT 
command. This is the only time that a disk’s "dirty" bit is set, although you may 
choose to rebuild the disk at other times to ensure integrity of its structure. 

If MOUNT discovers the disk needs rebuilding, it displays the message: 

Disk is being rebuilt - wait... 

The clustersize of files [0,1]BADB.SYS and [0,1]SATT.SYS are verified to ensure 
that they match the pack clustersize. 

The rebuild operation proceeds and the disk is logically mounted when the DCL 
prompt ($) for the next command appears. However, if the rebuild operation 
discovers blocks that have been allocated to more than one file (doubly allocated 
blocks), MOUNT displays a message asking which file to allocate each doubly 
allocated block to. You can choose a file at that point or stop and mount the disk 
without rebuilding, which lets you examine the situation further. 


Format 

MOUNT disk-device-name[:] pack-id [logical-name[:]] 


Command Qualifiers 

/OVERRIDE[=identification] 

/PRIVATE 

/PUBLIC 

/[NO]QUOTA 

/[NOJREBUILD 

/[NOJRESTRICT 

/[NO]SHAREABLE[=n] 

/[NOJWRITE 


Defaults 

none 


See Discussion 
See Discussion 
/NORESTRICT 
See Discussion 
See Discussion 


/PRIVATE 

/PRIVATE 


Prompts 

Device: device-name[:] 
Pack-id: pack-id 
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Command Parameters 


disk-device-name[:] 

Specifies the physical or logical name of the drive containing the disk you want to 
logically mount. 

pack-id 

Specifies the one to six character alphanumeric pack identification label written 
to the disk during initialization. (See the INITIALIZE command description in 
the section "INITIALIZE Command for Disks.") MOUNT then verifies that the 
pack-id written on the disk is the same as the label you specified in the MOUNT. 
This process helps make certain that you physically mounted the right disk. 

You must include a pack-id to mount a disk, unless you have the MOUNT 
privilege and use the /OVERRIDE qualifier. If you use this qualifier, do not enter 
the pack-id parameter, but only the device-name parameter and the logical-name 
parameter (if any). Generally, you should specify the pack-id to ensure mounting 
the correct disk. 

[logical-name[:]] 

Lets a user with INSTAL privilege assign a systemwide logical name to the disk 
drive specified by a device name. If you do not specify a logical name and you 
have INSTAL privilege, the system uses the pack-id label as a systemwide logical 
name for the drive. You may want to use this logical name to keep the pack-id 
from unauthorized users. Unauthorized users can see logical names assigned 
to devices in SYSTAT. RSTS/E ignores the specification of a logical name by an 
unauthorized user (without INSTAL privilege), but the mount succeeds. 

Command Qualifiers 

/OVERRIDE[=IDENTIFICATION] 

Eliminates the need to specify the pack-id when mounting the disk. The identifi¬ 
cation argument is optional and does not change the meaning of the qualifier. You 
must have MOUNT privilege to include this qualifier. If you include /OVERRIDE, 
then MOUNT assumes that the second parameter, if specified, is the logical name 
for the device instead of the pack ID. 

By default, you must include the pack ID of the disk. 

/PRIVATE 

/PUBLIC 

Declares that the disk you are mounting is accessible to all users on the system (a 
public disk), or only accessible to users who have accounts on the disk (a private 
disk). The default is /PRIVATE. 

The action taken for /PRIVATE and /PUBLIC depends on two things: 

• Whether you have MOUNT privilege when issuing the MOUNT command 

• Whether you initialized the disk as public or private 

In general, the disk is safeguarded, even against a user with MOUNT privilege, 
from being inadvertently made available for public use. 

For Users with MOUNT privilege 

If you have MOUNT privilege, you can MOUNT a disk initialized as private. 

You can explicitly declare the usage with the /PRIVATE or /SHAREABLE 
qualifier, but this is not required. You can also mount the disk with the 
/NOSHAREABLE=n qualifier, to make the disk accessible only to job n (see 
the discussion for /NOSHAREABLE[=n]). 
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Table 15-3 summarizes the possibilities of the /PUBLIC, /PRIVATE, and 
/[NO]SHAREABLE qualifiers. (If none of these qualifiers is specified, RSTS/E 
assumes /PRIVATE.) 

Table 15-3: The /PUBLIC, /PRIVATE, and /[NO]SHAREABLE Qualifiers for the MOUNT 
Command 


Privileges Public 


INITIALIZE for disk was: 

Private 


User does not have 
MOUNT privilege 

User has MOUNT 
privilege 


Any MOUNT returns an error. 

MOUNT with /PUBLIC succeeds: the 
disk is accessible to all users. 

MOUNT with /PRIVATE or 
/SHAREABLE succeeds: the disk is 
accessible to only those users with an 
account on the disk. 

MOUNT with /NOSHAREABLE[=n] 
succeeds; the disk is accessible only to 
job n (the user's job, by default). 
MOUNT with no qualifier succeeds as 
private disk: the disk is accessible to 
only those users with an account on 
the disk: RSTS/E displays a warning 
message. 


Only a MOUNT/NO SHAREABLE 
succeeds. 

MOUNT/PUBLIC returns an er¬ 
ror. MOUNT with no qualifier or 
with /PRIVATE, /SHAREABLE, or 
/NOSHAREABLE succeeds. 


/[ NOJQUOTA 

Controls whether quota checking is performed when the disk is mounted. This 
qualifier applies only to Level 1.2 disks. The default is /QUOTA. DVO: is always 
/NOQUOTA. 

/[NOJREBUILD 

Controls the rebuilding of a disk, regardless of whether the disk was initialized 
as read/write or read-only. A dirty disk is one that has been physically dis¬ 
mounted (removed from the drive) without being logically dismounted first by a 
DISMOUNT command. 

A DISMOUNT checks to see that no files are currently open on a disk. If files 
are open, the DISMOUNT does not succeed. If someone makes a mistake and 
physically removes a disk pack from a disk drive while programs are still using 
files on the disk, the usual M clean-up M operations that the RSTS/E monitor 
performs may not have occurred. For example, the monitor keeps the file 
SATT.SYS (the storage allocation table for the disk) in memory and updates it 
when files are added to or deleted from the disk. If someone physically dismounts 
a disk before the monitor has written SATT.SYS back to disk, the data in the old 
SATT.SYS will probably be incorrect. 

Rebuilding a disk requires MOUNT privilege. This operation performs necessary 
clean-up before the disk can be used again. Specifically, a rebuild operation: 

• Locates blocks that have been allocated to more than one file. The system 
displays a message listing the files to which such blocks have been allocated, 
and asks you to delete all but one of the files. 

• Deletes invalid directories. 

• Deletes all files that have the type .TMP, are marked for deletion, or have no 
accounting entry. 
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• Builds a new storage allocation table (SATT.SYS), to show current file 
allocations (after deletions accomplished by rebuilding). 

• Zeroes all blocks that were in the old storage allocation table (SATT.SYS), but 
not in the new one. This is done as a security precaution: in case these blocks 
belonged to files with a protection code of <128> or higher (which are always 
zeroed when they are deleted). 

A MOUNT operation for disk automatically checks to see if the disk is dirty. If 
so, and you have MOUNT privilege, a rebuild occurs automatically, regardless of 
whether you specify /REBUILD. The following message appears to indicate that 
the disk is being rebuilt: 

Disk is being rebuilt - wait ... 

However, if a user without MOUNT privilege tries to mount a dirty disk, RSTS/E 
displays the error message: 

?Disk needs rebuilding but you do not have MOUNT privilege 

The /REBUILD qualifier forces a rebuild on a disk. It lets the user with MOUNT 
privilege rebuild a disk that the system has not identified as "dirty." For example, 
some programs leave temporary files in the user’s account, rather than deleting 
them before the program exits. Such a disk is not flagged as dirty. If you want 
to get rid of the temporary files on a disk, you can mount the disk using the 
/REBUILD qualifier. 

If you specify /REBUILD and the drive is write-protected, RSTS/E displays the 
following error message: 

?Can't rebuild disk because device is write-protected 

If a user without MOUNT privilege specifies /REBUILD, RSTS/E displays the 
following error message: 

?You must have MOUNT privilege to rebuild the disk 

The /NOREBUILD qualifier overrides an automatic rebuild of a dirty disk. You 
may not want to take the time to rebuild the dirty disk. Or, the disk may have 
doubly allocated blocks, and you do not want to risk deleting them. In this case, 
you can mount the disk with the /NOREBUILD qualifier (thus granting only 
read-only access) and try to correct the situation. For example, you could use 
the COPY command to copy the files to new locations (where they do not contain 
doubly-allocated blocks) and try to sort out the situation from there. 

If you have MOUNT privilege, and specify /NOREBUILD to mount a dirty disk, 
the disk is mounted restricted and read-only; and two warning messages appear: 

%Disk needs rebuilding 

%Disk is restricted and mounted no-share, read-only 

Thus, the disk is accessible only to the job that mounted it. 

When a user without MOUNT privilege specifies /NOREBUILD to mount a 
"clean" (rebuilt) disk, the mount succeeds and the disk is unaffected. 

/[NOJRESTRICT 

Indicates whether the disk is restricted. If you specify the /RESTRICT qualifier 
in the MOUNT command line, only users with DEVICE privilege can access the 
specified disk. The default is /NORESTRICT. 
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/[NOJSHAREABLE 

Controls whether to limit disk access to: 

• Job n (/NOSHAREABLE=n) 

• The job that mounted the disk (/NOSHAREABLE) 

• Any user with an account on the disk (/SHAREABLE) 

A disk mounted as shared is the same as a disk mounted as private. A user with 
MOUNT privilege can mount a private or public disk as shared or nonshared. 

If you do not specify /PRIVATE, /PUBLIC, or /[NOJSHAREABLE, then the default 
action is to mount the disk as private (shared). 

The /NOSHAREABLE qualifier conflicts with either /PUBLIC or /PRIVATE. You 
can use /SHAREABLE with either /PUBLIC or /PRIVATE; its presence in the 
same command line as the other two qualifiers has no effect. 

/[NOJWRITE 

Controls whether data can be written to the mounted disk. 

If you specify /NOWRITE, the disk is wnte-protected, which means that no users 
can write to the disk. The /NOWRITE qualifier protects files on the disk; they 
can only be read from, not written to. 

If you specify /WRITE, users who access the disk can write to it. 

When you do not specify /WRITE or /NOWRITE, the default depends on whether 
the disk was initialized as read/write or read-only, and whether the disk is clean 
or dirty. For disks initialized as read-only, the default is to give read-only access 
(/NOWRITE) to the disk. For disks initialized as read/write, there are a few more 
conditions to consider. If the disk is clean or can be rebuilt (/NOREBUILD was 
not specified), and the drive is not write-locked, /WRITE is the default. If the disk 
is clean and the drive is write-locked, /NOWRITE is the default, and the following 
warning message appears: 

%Device write protected 

If the disk is dirty and /NOREBUILD was specified, the disk is mounted read¬ 
only, noshare. 


15-18 Managing Disks and Tapes 




15.2.6 MOUNT Command for Tapes 

This command for tapes verifies that the tape is properly loaded onto the unit 
and checks an ANSI tape for the label specified in the MOUNT command (ANSI 
tapes must have labels). Issue a MOUNT command after physically mounting a 
tape on a tape unit and placing it on line. 

If the device is restricted, MOUNT requires DEVICE privilege. 

Format 


MOUNT tape-device-name[:][label] 

Command Qualifiers 

Defaults 

/DENSITY=n 

See Discussion 

/FORMAT=tape-format 

See Discussion 

/OVERRIDE[=identification] 

none 

/[NO]WRITE 

Prompts 

Device: device-name[:] 

Label: label 

See Discussion 


Command Parameters 

tape-device-name[:] 

Specifies the physical or logical name of the drive on which the tape is physically 
mounted. If you do not specify a unit number with a physical device name, 
RSTS/E assumes unit 0. 

[label] 

This parameter is necessary only for ANSI tapes. If you try to mount an ANSI 
tape without specifying a label, RSTS/E prompts you for a label. 

A label is not required (and is ignored) when you mount a tape in DOS or foreign 
format. In this case, RSTS/E displays a warning message: 

%Label ignored 

The label specifies the one- to six-character alphanumeric label written to the 
tape when it was initialized (see the INITIALIZE command description in the 
section "INITIALIZE Command for Tapes"). MOUNT then verifies that the label 
on the tape is the same as the one you specified in the MOUNT command. This 
process helps make certain that you have mounted the right tape. 

Command Qualifiers 

/DENSITY=n 

Specifies the density in bits per inch (bpi). The argument nnn can be any number 
between 2 and 32,766, or the keywords MINIMUM or MAXIMUM can be used. 
Generally, available tape drives support 800, 1600, 6250, 6667, 8000, or 10,000 
bpi. 
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If you specify MINIMUM or MAXIMUM, the system checks the tape drive and 
sets the density to the minimum or maximum the drive supports. If you specify a 
density that the tape drive does not support, RSTS/E displays an error message 
and aborts the command. If you do not specify a density, the default is the system 
default density. 

/FORMAT = tape-format 

Indicates whether the tape is in a standard format used by the RSTS/E operating 
system. The default format is the current system default (see SHOW SYSTEM, 
Chapter 14). 

The RSTS/E System User’s Guide describes ANSI and DOS formats. A tape is 
FOREIGN if it is not in ANSI or DOS format. 

NOTE 

If you mount a tape with /FORMAT=FOREIGN, the program you use 
to read the tape must know what types of labels there are on the tape 
or be able to process any labels on the tape. 

/OVERRIDE[=identification] 

Lets you mount ANSI magnetic tapes without specifying the label name. Since 
DOS format tapes have no label, the /OVERRIDE qualifier is ignored if the tape 
format is DOS. The identification argument is optional and does not change the 
meaning of the qualifier. You need no privileges to use the /OVERRIDE qualifier. 

/[NO]WRITE 

RSTS/E checks to see whether the tape is read/write (the write ring is present) or 
read-only (the write ring is not present). 

If the write ring is not present and you specify /WRITE, RSTS/E displays the 
following error message: 

?Device is write protected 

If the write ring is not present and you do not specify either qualifier, RSTS/E 
displays the following warning: 

%Device is write protected 
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Chapter 16 

Backing Up and Restoring Files 


Backing up disk files and accounts means copying the contents of the disk to 
another volume or set of volumes. Backing up disks is a precautionary measure 
to let you recover from the loss or destruction of valuable information. 

Most sites establish a policy and a schedule for regularly backing up disk files. 
This chapter provides the operating procedures for backing up both selected files 
and entire disks. 

It is just as desirable to back up information on private disks as it is to back up 
public disks. However, responsibility for backing up the files on private disks 
could be left to the individual owners of those files and disks. 

There are two kinds of backups of disk files: 

• Incremental, or partial backups 

• Full, or all-inclusive, backups 

In either case, the backup medium can be disk or magnetic tape. Incremental 
backups save only those files that have been modified recently. Periodic full 
backups are necessary to provide the basis for reconstruction of an entire disk. 

As a rule, incremental backups are undertaken more frequently than full 
backups. After consulting with users of the system, you decide how often to back 
up files and volumes and how long to retain backup media. 

Generally, you are responsible for setting up a schedule for backing up files and 
accounts, and for maintaining this schedule. The following schedule for backing 
up public disk volumes on magnetic tape affords adequate protection of data for 
many installations: 

• Daily—An incremental backup retained for seven days. This schedule 
requires seven daily tapes (or sets of tapes) that are rotated once a week. 

• Weekly—An incremental backup retained for four weeks. This schedule 
requires four weekly sets of tapes that are rotated once every four weeks. 

• Monthly—An all-inclusive backup retained for a year. This schedule requires 
twelve monthly sets of tapes that are rotated once a year. 

Despite all precautions, there is always the risk of losing a file. Frequent backups 
and longer retention periods reduce this risk. You may also want to consider an 
off-site storage facility for the monthly save sets. 
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You can perform full backups to magnetic tape or to another disk. Each has 
its advantages and disadvantages. The advantage of using magnetic tape for 
backups is the much lower media and storage cost, which may permit you to 
retain backups longer than keeping full backups on disk. 

However, there are several advantages to keeping copies on disk, which in 
some cases outweigh the higher cost. Disks exhibit better data reliability than 
magnetic tapes. Furthermore, disks tend to degrade less in storage. 


16.1 Recovering Your System Disk (RECOVR) 

You can use the BACKUP utility and the command file RECOVR.COM to 
recreate your system disk in case it becomes corrupted. RECOVR.COM is located 
in account [0,1]. 

BACKUP lets you back up your system disk once it is ready for normal time¬ 
sharing; RECOVR.COM creates a bootable disk or tape with the minimum files 
needed to start your system. Use the disk or tape in the following procedure to 
create a recovery medium and restore your system disk: 

Creating the recovery medium: 

1. After the system is installed and running, use the DCL BACKUP command 
to create a full backup of all accounts and files on the system. 

2. Once the backup is finished, use the command file RECOVR.COM to create 
the bootable disk or tape from which the RESTORE command can recreate 
the system disk. 

Perform system backups on a regular basis. 

Recreating the system disk: 

1. Boot the recovery disk or tape you created with the RECOVR.COM file. See 
Chapter 2 for a description of this procedure. 

2. Begin installation procedures. Note that this will reinitialize the system disk. 

3. After you answer "yes" to the "Start timesharing?" prompt, the system 
displays a message stating it is ready for you to begin using the RESTORE 
command. 

4. At the DCL prompt, physically mount your latest full backup set. Enter the 
RESTORE/ACCOUNTING command. 

5. Next, mount the latest incremental backup (if you do incremental backups) 
and enter the RESTORE/ACCOUNTING/REPLACE command. 

6. When the restore completes, nm the SHUTUP program and restart the 
system using your normal monitor (restored from the backup set). 

The system disk is now back to the point of the last backup. 


16.2 Using BACKUP on a Two Disk System 

On a system having only two disk drives and no magnetic tape drive, it is 
normally not possible to perform a backup of the nonsystem disk, because this 
procedure would require that the system disk (from which BACKUP is being 
run), the disk being backed up, and the backup target volume all be mounted 
simultaneously. Such a procedure would require three or more disk drives, or the 
addition of a magnetic tape drive. 
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A solution to this problem is to place a minimum bootable system on the 
nonsystem disk, allowing it to run as the system disk for offline BACKUP 
operations. The major disadvantage to using this procedure is that the files for 
the minimum system require approximately 1700 blocks on the nonsystem disk. 

If you have only RL02s, consider expanding your hardware to include another 
disk drive or a magnetic tape drive. For disks larger than RL02s, the overhead of 
having a minimum system on each nonsystem disk is usually small enough to be 
tolerable, although you must decide based on your system needs. 

You should put the minimum system on the nonsystem disk immediately after 
initializing the disk using DSKINT. This ensures that there is enough space for 
the minimum system. To do this, perform the procedures outlined below. In the 
following example, the notation "xxn:" indicates the nonsystem disk to which 
you are copying the minimum system, and "xxxxxx.SIL" indicates your currently 
installed monitor SIL: 

1. If you have not yet initialized the nonsystem disk that you plan to use, 
initialize it using the DCL INITIALIZE command or the DSKINT utility. 
Then mount the disk using the MOUNT command. 

2. Issue the following commands: 

$ COPY [0,1]INIT.SYS xxn:[0,1]/CLUSTER_SIZE=16 

$ RUN SYSGEN$:HOOK.SAV 
CHOOK's header line> 

*xxn :[0,1]INIT.SYS 
Hook complete 
* A Z 

$ COPY [0,1]DCL.RTS, [0,1]PKG*.MSG xxn:[0,1] 

$ COPY [0,1]ERR.ERR,[0,1]CONFIG.SYS xxn:[0,1] 

$ COPY/ALLOC=136/CONT NL: xxn:[0,1]SWAP.SYS 
$ COPY [0,1]xxxxxx.SIL xxn:[0,1] 

$ COPY [0,1]BACKUP.TSK xxn:[0,1] 

3. Your nonsystem disk is now ready to use. You can dismount it and remount it 
as a public or private disk if you desire. When you want to back up that disk, 
you must shut down your system, bootstrap the nonsystem disk, and mount 

a scratch disk in place of your normal system disk. Start timesharing and 
use BACKUP or BACKUP/IMAGE to copy your nonsystem disk to the backup 
disk. 

NOTE 

Every time you install an update, you must delete the copies of 
INIT.SYS on any other disks to which you have copied it, and repeat 
the above procedure. 


16.3 DCL Command Descriptions 

Files created by BACKUP are called Backup sets. A Backup set is a RSTS/E file 
that can be copied just like any other RSTS/E file. However, only BACKUP and 
RESTORE can interpret the data in a Backup set. 

You can use six DCL commands: BACKUP, RESTORE, BACKUP/DIRECTORY, 
RESTORE/DIRECTORY, BACKUP/IMAGE, and BACKUP/COPY. 
BACKUP/DIRECTORY and RESTORE/DIRECTORY perform the same function, 
which is to list the contents of a backup set. BACKUP/IMAGE lets you make a 
complete image copy of a source disk onto an output disk. In addition to copying 
all accounts and files, BACKUP/IMAGE also makes the output disk bootable, 
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provided the input disk was bootable and the file [0,1]INIT.SYS was copied to the 
output disk. 

BACKUP/COPY performs the same function as BACKUP/IMAGE except that 
it allows most of the operational and file selection qualifiers that BACKUP and 
RESTORE allow. BACKUP/COPY does not create a bootable output disk. 

NOTE 

Privileges may be required to use certain qualifiers (for example, 
/ACCOUNT_DATA requires GACNT or WACNT privilege). If you want 
to delegate the responsibility for backing up certain files (for example, 
files on private disks) to the individual owners, they will need GREAD 
or WREAD privileges. 


16.3-1 BACKUP Command 


This command creates a Backup set on a specified disk or magnetic tape from one 
or more RSTS/E disk files. Once the BACKUP utility determines the syntactical 
validity of the command specification and issues any warning message relative to 
either the command or the environment, BACKUP prompts with: 

Please mount volume 1 of Backup set backup-set-name 
Where can this volume be located <default>l 

At the prompt, enter the device name to write the Backup set to. The default is 
the output device you specified in the BACKUP command line. You can use the 
/INITIALIZE and /NOINITIALIZE qualifiers to control initialization of the output 
device. 

Privileges required: 

• Read access to input files 

• Create access to the backup-set file 

• WACNT or GACNT to use /ACCOUNT_DATA qualifier 

• INSTAL to exceed the system dynamic region limit 

• TUNE to use /BUFFER_SIZE qualifier 


Format 

BACKUP filespec[,...] backup-set 

Command Qualifiers 
/[NO]ACCOUNT_DATA 
/[NO]ASSIST 
/BLOCK_SIZE=value 

/BUFFER_SIZE=value 

/[NOJCRC 

/CREATED=(date:time) 

/MODIFIED=(date:time) 

/DENSITY=value 

/END=action 


Defaults 

/ACCOUNTDATA 
/NO ASS 1ST 
28672 for disks 
8192 for tapes 
See discussion 
/NOCRC 
See discussion 

Highest available 
/END=DISMOUNT for disks 
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/EXCLUDE=(filespec-list) 

/[NO]FILE_DATA 

/[NO]GROUP_SIZE[=n] 

/INCLUDE=(filespec-list) 

/[NO]INITIALIZE[=(condition[,...])] 

/IN_LABEL=name 

/[NO]LIST_FILE[=filespec] 

/OUT_LABEL=name 

/[NO]OUTPUT[=filespec] 

/[NOJPROMPT 

/[NO]QUERY 

/[NO]REWIND 

/[NO]VERIFY[=ONLY] 


/END=NOREWIND for tapes 

No files excluded 

/FILE_DATA 

/GROUP_SIZE=10 

No files included 

/NOINITIALIZE 

Volume ID is not checked 

/LIST_FILE=KB: 

See discussion 
/OUTPUT=KB: 

/PROMPT 

/NOQUERY 

/NOREWIND 

/NOVERIFY 


Prompts 

See Discussion 


Restrictions 


Backup sets produced by the BACKUP utility are not bootable. Reboot using a 
recovery medium (for example, a disk or tape produced by RECOVR.COM or the 
latest installation kit) then use the RESTORE command to restore the backup 
set. 


Command Parameters 

filespec[,...] 

Identifies the files located on a disk to be backed up. The file specification should 
be a standard RSTS/E file specification or a list of specifications separated by the 
plus (+) sign or a comma (,): 

If you do not specify device, the default is SY:. The PPN is optional and defaults 
to the user’s current account. You can use wildcards in the PPN. The file 
specification is optional and defaults to *.*. You can use standard wildcards. 

If you specify a filename but not the type, BACKUP assumes a * type. If the 
filename ends with a period, BACKUP assumes a null type. If you specify a file 
type, you must also specify a filename. 

backup-set 

Identifies the disk or tape where the Backup set is to be created. The Backup 
set specification should be a standard RSTS/E file specification. You must specify 
the device. PPN is optional and defaults to the user’s current account. The file 
specification is optional and defaults to BACKUPBCK. If the backup operation 
needs more than one volume in the Backup set, BACKUP prompts you, or an 
operator if you specify /ASSIST, for subsequent volumes as follows: 

Please dismount volume 1 of Backup set backup-set-name 
Please mount volume 2 of Backup set backup-set-name 
Where can this volume be located <default>l 
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Command Qualifiers 


/[NO]ACCOUNT_DATA 

If you specify /ACCOUNT_DATA and you have the necessary privileges (GACNT 
or WACNT), BACKUP preserves all pertinent information about the account 
(quotas, password, privileges, and so on). RSTS/E uses this data to recreate or 
update accounts during a RESTORE. 

If you do not have accounting privileges (GACNT or WACNT), BACKUP only 
saves the attributes of accounts that you have access to. In particular, you can 
not access the password attribute or restricted user attributes. 

If you specify /NO ACCOUNTJDATA, BACKUP will not back up account informa¬ 
tion, but will back up file data only. 

/[NO]ASSIST 

If you specify the /ASSIST qualifier, all backup prompts for mounting and 
initializing output media, and all responses to those prompts, are routed through 
OMS to an operator. /ASSIST is useful when performing a backup within a batch 
procedure. 

To receive and answer these prompts through OMS, use the DCL command SET 
TERMINAIVOPERATOR. The default is /NOASSIST. 

/BLOCK_SIZE=value 

The /BLOCKJ3IZE qualifier lets you select the block size used for the output 
Backup set. You must specify the value argument. Value can be in the range 
2048 to 28672 bytes for both disks and tapes. Further, the value must be a 
multiple of 16 for tape and 512 for disk. You can also specify the keywords 
MINIMUM and MAXIMUM. 

If you do not specify /BLOCKJ3IZE, BACKUP uses 28,672 bytes for disks and 
16,384 bytes for tapes. 


NOTE 

Use of this qualifier can affect the performance and reliability of 
BACKUP. If you use large values, BACKUP operates faster and creates 
a smaller backup set. Smaller values cause less data to fit into a given 
volume; however, they can increase the reliability (see the description 
of the /GROUPJ3IZE qualifier). 

/BUFFER_SIZE=value 

The /BUFFER_SIZE qualifier controls the size of the dynamic region used by 
BACKUP. The valid range is 3 to 255. You can also use the keywords OPTIMUM 
and MAXIMUM. The value represents the number of K-words of memory to be 
used by BACKUP as buffer space. In general, the larger the value, the faster 
BACKUP performs. However, large numbers increase the system loading and 
resource usage, and can seriously impact other users. 

If you omit /BUFFERJ3IZE, BACKUP uses the minimum buffer space required 
for the specified block size, consistent with the other qualifiers, or a value of 55 
for MU: and MS: devices. If the amount of memory requested is not available, 
BACKUP uses as much memory as possible and displays an informational 
message. If you specify MAXIMUM, BACKUP uses a value of 255 or as much 
available memory as possible without displaying any message. 

If you specify OPTIMUM, BACKUP uses a value of 55. 
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/[NO]CRC 

Controls the generation of 32-bit cyclic redundancy check (CRC) codes to better 
detect data errors. Every block header includes a 16-bit CRC, but this only 
detects errors in the header. The 32-bit CRC produced by the /CRC qualifier 
detects errors anywhere in the block. The process of generating CRC code blocks 
uses significant amounts of CPU time, and may degrade streaming performance 
on some systems. 

When restoring a backup set written with /CRC, RESTORE automatically checks 
the CRC. If RESTORE finds a CRC error, it attempts to recover the data. The 
default is /NOCRC. 

/CREATED=(date:time) 

/MODIFIED=(date:time) 

The /CREATED and /MODIFIED qualifiers let you select the files to be backed 
up, as chosen by the file specification criteria (see the input-file-spec description), 
based on the creation date/time and/or revision date. If no file specification 
criteria exist, these qualifiers apply to all files on the input volume for this 
operation. You can use /CREATED and /MODIFIED in conjunction with each 
other; they are not mutually exclusive. To be selected, a file has to satisfy all the 
criteria you specify. 

You can specify an exact date or range of dates for either qualifier. In the range 
format, each qualifier must take an argument of one or both of the subqualifiers 
BEFORE or AFTER. The subqualifier order in the argument is immaterial. 

The date-time argument is of the standard form (for example, dd-mmm-yy or 
yy.mm.dd and hh:mm A/PM or hh:mm). You must specify the date. If you do not 
specify the time, it defaults to 00:00. In addition, if you specify the time, you 
must separate it from the date by a colon (:). 

The following generic terms can be used in the subqualifier: 

• TODAY—meaning 00:00 on the current (system) date 

• YESTERDAY—meaning 00:00 on the date previous to the current date 

When used with /CREATED, the generic terms also accept a time argument. 

If you do not specify either /CREATED or /MODIFIED, BACKUP selects all 
specified files for transfer to the Backup set. 

NOTE 

Files transferred by BACKUP retain their original creation and 
revision dates (that is, the dates on the source volume). You need the 
DATES privilege to keep these original dates; otherwise, RSTS/E lists 
the current date as the creation date of the backed-up file. 

/DENSITY=value 

Specifies the recording density on the output tape. Specify any valid density 
for the tape you are using for the output. You can also specify the keywords 
MINIMUM and MAXIMUM. Generally, available tape drives support 800, 1600, 
6250, 6667, 8000, OR 10,000 bpi. 

If you specify MINIMUM or MAXIMUM, BACKUP checks the tape drive and 
sets the density to the minimum and maximum the drive supports. If you select 
a density that is not valid for the drive addressed, BACKUP displays a warning 
message and selects the highest density (below the specified value) that the drive 
supports. If you do not specify a density, the default value is the highest density 
available on the drive addressed. 
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You can only specify this qualifier for the first volume of a Backup set. 

Subsequent volumes are written at the same density as the first volume un¬ 
less the addressed drive is different from the first drive and the original density 
is not available on the addressed drive. In this case, the density is the highest 
density available for the addressed drive. 

/END=action 

Specifies the disposition of the tape or disk drive at the end of the backup 
operation. 

For tapes, /END=[NO]REWIND specifies whether or not to rewind the output 
tape after the BACKUP operation is complete. The default is /END=REWIND, 
which leaves the tape positioned immediately after the backup set just written. 

For disks you can specify /END=[NO]DISMOUNT. The default is /END=DISMOUNT. 

/EXCLUDE=(filespec-list) 

Lets you specify files that you want excluded from the BACKUP operation (for 
example, [0,1]SWAP?.SYS). You can include a list of file specifications in the 
command line up to the maximum length of a DCL command line. The default is 
that no files are excluded. 

/[NO]FILE_DATA 

Controls the transfer of file data during a backup operation. If you specify 
/FILE_DATA, the operation proceeds with actual file data being transferred to the 
Backup set from the RSTS/E volume. If you specify /NOFILE_DATA, no files are 
written to the Backup set. Use /NOFILEJDATA with /ACCOUNT_DATA to back 
up only accounting data. The default is /FILE_DATA. 

/[NO]GROUP_SIZE[=n] 

Specifies the group size for XOR redundancy. The optional argument can be a 
decimal number from 0 to 100. If you specify zero (equivalent to /NOGROUP_ 
SIZE), BACKUP creates the Backup set without XOR redundancy. The default is 
/GROUP_SIZE=10. 

The /GROUP_SIZE qualifier causes additional error recovery data to be stored 
in the Backup set. RSTS/E uses this information to recover from media errors 
during a RESTORE operation. 

The smaller the number, the greater the chance of recovering from data errors on 
RESTORE. Note that a smaller number also makes the Backup set larger. 

RESTORE can recover from one error in each group. So, for example, if you 
specify /GROUP_SIZE=20, RESTORE can recover from one error in every 20 
blocks. That is, with /GROUP_SIZE=20, RESTORE cannot recover from 2 or 
more errors every 20 blocks. Note that the /BLOCK_SIZE qualifier sets the size 
of each Backup set block. So, if RESTORE cannot recover 2 blocks of data, you 
lose 2 blocks of that size. In general, if something cannot be recovered, you lose 
less data with a smaller /GROUP_SIZE. 

/INCLUDE=(filespec-list) 

Lets you specify files or accounts that you want to be unconditionally pro¬ 
cessed. You can include a list of file specifications in the command line up to the 
maximum length of a DCL command line. 

Files in this set override those excluded with the /EXCLUDE qualifier. 

/[NO]INITIALIZE[=(condition[,...])] 

Specifies the disposition of the output media prior to the data transfer operation 
and sets the default device specification in the "Where can this volume be located 
<default>?" prompt. 
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For disk volumes, /INITIALIZE specifies that any file structure on the disk is to 
be disregarded and the volume is to be reinitialized with a RSTS/E file structure 
as if it were done with the INITIALIZE command. 

BACKUP also creates a nonuser account on the disk to hold the Backup set. That 
account is the account explicitly specified in the output specification, or implicitly 
specified as the current account of the user issuing the command. The pack 
cluster size is 16, the UFD cluster size is 16, and the file cluster size for the save 
set is set to the amount of free space on the disk divided by 100, rounded up to 
the next highest power of two. BACKUP does not define any accounting data for 
the created account. 

For magnetic tape volumes, /INITIALIZE specifies that BACKUP initializes the 
tape as a standard ANSI tape. 

You can only specify /NOINITIALIZE when doing a BACKUP to tape to create 
a new Backup set to be appended to the end of a tape containing other files 
(possibly other Backup sets). 

You can specify: 

• /INITIALIZE=[NO]ERASE to inform DSKINT whether or not to erase the 
disk. 

• /INITIALIZE=[NO]EXERCISE[=n] to indicate whether or not you want 
DSKINT to exercize the disk. Allowable values for n are 0, 1, 2, and 3. 

• /INITIALIZE=CLUSTER_SIZE=n to have DSKINT initialize the disk the 
specified cluster size. Allowable values for n are 1, 2, 4, 8, 16, 32, and 64. 

• /INITIALIZE=[NO]QUERY to inform DSKINT whether or not to display the 
"Proceed (Y or N)?" prompt. 

If you use more than one argument, enclose them in parentheses and separate 
them with commas. 

/IN_LABEL=name 

Specifies the name to be compared to the source volume ID. If you use this 
qualifier, the source volume ID must equal the specified name before BACKUP 
can perform the requested operation. 

/[NO]LIST_FILE[=filespec] 

Controls the production of a directory-like listing file that catalogues the sequence 
of events in the BACKUP operation. The file specification can be any valid 
RSTS/E file specification (wildcards are not allowed). The default is your terminal 
(KB:). 

You can use this qualifier to produce a listing of files in the Backup set. 

/OUT_LABEL=name 

Specifies the desired name for the output volume ID. The resultant name can 
vary depending on the interaction between /OUT_LABEL and /[NOJINITIALIZE. 

Table 16—1 summarizes the possible outcomes of the interaction of /OUT_LABEL 
and /[NOJINITIALIZE during BACKUP. 
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Table 16-1: /INITIALIZE and /OUT LABEL Interaction During BACKUP 


Qualifiers 

Specified 

/ OUT LABEL=name 

/INITIALIZE 

/OUT_LABEL=name 

/NOINITIALIZE 

/INITIALIZE 

(only) 

/NOINITIALIZE 

(only) 


Output Volume ID 

The specified name. 

The specified name; however, the operation is only 
successful if the output volume label has the same name. 

BACKUP supplies the name "BACKUP”. 

The name is unchanged. 


/[NO]OUTPUT[=filespec] 

Controls the production of a directory-like listing file that catalogues the sequence 
of events in the BACKUP operation. The file specification can be any valid 
RSTS/E file specification (wildcards are not allowed). You can use this qualifier 
to produce a listing of files in the Backup set. /NOOUTPUT is a synonym for 
/NOLIST_FILE. The default is your terminal (KB:). 

/[ NOJPROMPT 

Normally, the Backup utility issues a MOUNT prompt, for each BACKUP 
operation even if the Backup set’s device is already mounted. You can eliminate 
the prompt for the first volume by including the /NOPROMPT qualifier in your 
command line. The default is /PROMPT. 

/[NO]QUERY 

Causes BACKUP to prompt the user for each file that meets the selection criteria 
as to whether or not the file should be transferred. A Y[ES] response effects the 
transfer. A response of N[0] or pressing Return bypasses the file. Any other 
response causes the prompt to be reissued. 

A YES/ALL response causes the current file and all remaining files to be trans¬ 
ferred without any further prompting. A response of NO/ALL causes the current 
file and all remaining files to be bypassed without any further prompting. 

The default is /NOQUERY. 

/[NO]REWIND 

For tape backup files, indicates whether to rewind the tape before searching for 
the logical end of tape to create the backup file. 

BACKUP must locate the logical end of tape so that it can create the backup file 
after any files already on the tape. While searching for the end of tape, BACKUP 
will check the name of each file it encounters and report an error if it finds a file 
with the same name as the backup file. This prevents having two files with the 
same name on the tape. 

If you specify /REWIND, BACKUP rewinds the tape and scans the entire tape for 
a duplicate file. 

If you specify /NOREWIND, then BACKUP scans from the tape’s current position, 
and will not detect duplicate files located earlier on the tape. The default is 
/NOREWIND. 

/[NO]VERIFY[=ONLY] 

The /VERIFY qualifier specifies that a comparison operation is to be performed 
on all data transferred. This postprocess verification reports the presence of any 
data differences. For any differences found, BACKUP displays the PPN, file 
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name, and file type at the user’s terminal. /VERIFY=ONLY causes the verify 
only pass to be made over the same input and output specifications used for the 
backup pass. You can use /VERIFY=ONLY to compare the contents of a backup 
set with the source disk to determine what files have changed since the backup 
set was created. You can also use this qualifier to verify several backup sets on 
one tape without having to wait for the tape to rewind after each backup set. 

The default is /NOVERIFY. 

Examples 

BACKUP DRlsPAYROL.DAT MTO:PAYROL.BCK 

This command saves a file to a save set on tape 
o 

BACKUP/ACCOUNT_DATA DU1:[*,*]*.* MMO:1409MA.BCK 

This command saves a disk to a save set on tape 

3 * BACKUP DR2iPAYROL.DAT,DR2sBENEFI.DAT,DR2iVACATI.DAT MTO:DAT17M.BCK 

This command saves a list of files to a save set on tape 

A 

BACKUP/BUFFER_SIZE=75/INITIALIZE - 
LIST_FILE=SYDISK [*.*]*.* MUO:/END=REWIND - 
EXCLUDE=[0,1]??????.SYS/NOPROMPT/VERIFY 

This command performs a full backup of a disk 

BACKUP/BUFFER_SIZE=75/INITIALIZE - 
CREATE=AFTER=4-FEB-90:9:28 - 

LIST_FILE=SYDISK [*.*]*.* MUO:/END=REWIND - 
EXCLUDE=[0,1]??????.SYS/NOPROMPT/VERIFY 

This command performs an incremental backup of a disk, (following an earlier 
full backup) 
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16.3.2 BACKUP/COPY Command 


Copies files, accounts, or volumes from one disk to another. BACKUP/COPY is 
particularly useful for copying large amounts of data from one disk to another, o 
from one account to another. BACKUP/COPY provides higher performance that 
the DCL COPY command because of its use of asynchronous I/O. 

Privileges required: 

• Read access to input files 

• Create access to output files 

• DATES to preserve creation/access dates on output files 

• INSTAL to exceed system dynamic region limit 

• SYSIO to transfer files to account [0,1] 

• TUNE to use BUFFERJ3IZE qualifier 

• WACNT or GACNT to use the /ACCOUNT_DATA qualifier 


Format 

BACKUP/COPY source-file$pec[,...] output-filespec 


Command Qualifiers 

/[NO]ACCOUNT_DATA 

/[NOJASSIST 


Defaults 

/ACCOUNT_DATA 

NOASSIST 


/BLOCK_SIZE=value 

/BUFFER_SIZE=value 

/CREATED=(date:time) 

/MODIFIED=(date:time) 

/END=[NO]DISMOUNT 

/EXCLUDE=filespec[,...] 

/[NO]FILE_DATA 


28672 for disks 
See discussion 
See discussion 


/INCLU DE=filespec[,...] 

/[NO] IN ITI ALIZE[=(condition[,...])] 

/IN_LABEL=label 

/[N O] LIST_F I LE[=f i lespec] 

/[NO]OPTIMIZE[=(list)] 


/[NO]OUTPUT[=filespec] 

/OUT_LABEL=label 

/PLACED_POSITION=position 

/[NO]PROMPT 

/[NO]QUERY 

/[NO]REPLACE[=QUERY] 

/[NO]VERIFY[=ONLY] 


/END=DISMOUNT 

None 

/FILE_DATA 

None 

/NOINITIALIZE 
Not checked 
/LIST_FILE=KB: 

/OPTIMIZE 

in-label if you use /INITIALIZE 

Your terminal 

Not checked or is 

/PLACED_POSITION=INDEX 

/PROMPT 

/NOQUERY 

/REPLACE=QUERY 

/NOVERIFY 
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Command Parameters 


source-filespec[,...] 

Identifies the file or files to be copied. The file specification should be a standard 
RSTS/E file specification (including wildcards) or a list of specifications separated 
by the plus (+) sign or a comma (,): 

If you do not specify a device, the default is SY:. The PPN is optional and 
defaults to the user’s current account. You can use wildcards in the PPN. The file 
specification is optional and defaults to *.*. You can use standard wildcards. If 
you specify a filename but not the type, BACKUP/COPY assumes a * type. If the 
filename ends with a period, BACKUP/COPY assumes a null type. If you specify 
a file type, you must also specify a filename. 

output-filespec 

Specifies the disk, account or files on a disk to receive the output. You can include 
a device, an account PPN (including wildcards), or a filespec (including wildcards). 
If you do not specify a device, the default is SY:. If you do not specify a PPN, the 
default is the input PPN. 

Command Qualifiers 

/[NO]ACCOUNT_DATA 

Indicates whether to create or update accounts on the output disk. /ACCOUNT^ 
DATA creates any account that does not already exist on the output disk. If the 
account exists on the output disk, then BACKUP/COPY updates the account’s 
attributes to match those of the account on the input disk. If you specify 
/NOACCOUNT_DATA, BACKUP/COPY will not transfer any files to an account 
that does not exist on the output disk. The default is /ACCOUNT_DATA. 

/[ NOJASSIST 

If you specify the /ASSIST qualifier, all prompts for mounting output media, and 
all responses to those prompts, are routed through OMS to the operator. /ASSIST 
is useful when running from a .COM file. 

lb receive and answer prompts through OMS, use the DCL command SET 
TERMINAL/OPERATOR. List file information and other output not requiring 
user response are not sent to OMS, but go where they normally go. 

An operator replies to the volume mount request using the REPLY/TO command. 
The possible replies are: 

• REPLY/ABORT to terminate the operation and is similar to typing Ctrl/Z in 
response to the mount prompt. 

• If the operator does not include any text with the reply, the volume mount 
default is used and is the same as pressing RETURN to the mount prompt. 

• If the operator includes text with the reply, the text is used as the response to 
the mount prompt. For example: 

$ REPLY/TO=317 "DMO:/INIT=(NOERASE,NOEXERCISE,CLUSTERSIZE=16)" 

This reply mounts the next backup volume on disk DMO: and initializes the 
disk using the specified initialization options. 

The default is /NOASSIST. 
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/BLOCK__SIZE=value 

The /BL0CKJ3IZE qualifier lets you select the block size used for the output 
copy. You must specify the value argument. Value can be in the range 2048 to 
28672 bytes for disks. Further, the value must be a multiple of 512. You can also 
specify the keywords MINIMUM and MAXIMUM. 

If you do not specify /BLOCK_SIZE, BACKUP/COPY uses 28672 bytes. 

NOTE 

Use of this qualifier can affect the performance of BACKUP/COPY. If 
you use large values, BACKUP/COPY operates faster and uses a larger 
buffer size. 

/BUFFER_SIZE=value 

The /BUFFERJ3IZE qualifier controls the size of the dynamic region used by 
BACKUP/COPY. The valid range is 3 to 255. You can also use the keywords 
OPTIMUM and MAXIMUM. The value represents the number of K words of 
memory to be used by BACKUP/COPY as buffer space. In general, the larger the 
value, the faster BACKUP/COPY performs. However, large numbers increase the 
system loading and resource usage, and can seriously impact other users. 

If you omit /BUFFERJ3IZE, BACKUP/COPY uses the minimum buffer space 
consistent with the other qualifiers, or a value of 55 for MU: and MS: devices. 

If the amount of memory requested is not available, BACKUP/COPY uses as 
much memory as possible and displays an informational message. If you specify 
MAXIMUM, BACKUP/COPY uses a value of 255 or as much available memory as 
possible without displaying any message. 

If you specify OPTIMUM, BACKUP/COPY uses a value of 55. 

/CREATED=(date:time) 

/MODIFIED=(date:time) 

The /CREATED and /MODIFIED qualifiers let you select the files to be copied, as 
chosen by the file specification criteria (see the input-file-spec description), based 
on the creation date/time and/or revision date. If no file specification criteria 
exist, these qualifiers apply to all files on the input volume for this operation. You 
can use /CREATED and /MODIFIED in conjunction with each other; they are not 
mutually exclusive. To be selected, a file has to satisfy all the criteria you specify. 

You can specify an exact date or range of dates for either qualifier. In the range 
format, each qualifier must take an argument of one or both of the subqualifiers 
BEFORE or AFTER. The subqualifier order in the argument is immaterial. 

The date-time argument is of the standard form (for example, dd-mmm-yy or 
yy.mm.dd and hh:mm A/PM or hh:mm). You must specify the date. If you do not 
specify the time, it defaults to 00:00. In addition, if you specify the time, you 
must separate it from the date by a colon (:). 

The following generic terms can be used in the subqualifier: 

• TODAY—meaning 00:00 on the current (system) date 

• YESTERDAY—meaning 00:00 on the date previous to the current date 

When used with /CREATED, the generic terms also accept a time argument. 

If you do not specify either /CREATED or /MODIFIED, BACKUP/COPY selects 
all specified files for transfer to the output set. 
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NOTE 


Files transferred by BACKUP/COPY retain their original creation and 
revision dates (that is, the dates on the source volume). You need the 
DATES privilege to keep these original dates; otherwise, RSTS/E lists 
the current date as the creation date. 

/END=[NO]DISMOUNT 

Specifies whether or not to dismount the disk drive at the end of the copy 
operation. The default is /END=DISMOUNT. 

/EXCLUDE=filespec[,...] 

Specifies one or more files that should not be transferred. This qualifier is useful 
when you use wildcards to select a group of files, but want to exclude particular 
files from the group. 

/[NO]FILE_DATA 

Indicates whether to transfer file data or only account data from the input to the 
output disk. Specify /NOFILE_DATA in conjunction with /ACCOUNT_DATA to 
create or update accounts on the output disk without transferring any files. The 
default is /FILE.DATA. 

/INCLUDE=filespec[,...] 

Specifies one or more files that should be transferred, regardless of any other 
selection criteria. For example, if you select files based on their creation date, you 
can still transfer files that would not otherwise be selected. 

/[NO]INITIALIZE=(condition[,...]) 

Indicates whether to initialize the output disk before transferring accounts or 
files. You must use this qualifier if the output disk is a new disk or one without a 
RSTS file structure. 

If you specify /INITIALIZE, the output disk will be initialized based on the 
attributes (pack ID, pack cluster size, etc.) of the input disk. The default is 
/N OINITIALIZE. 

You can specify: 

• /INITIALIZE=[NO]ERASE to inform DSKINT whether or not to erase the 
disk. 

• /INITIALIZE=[NO]EXERCISE[=n] to indicate whether or not you want 
DSKINT to exercise the disk. Allowable values for n are 0, 1, 2, and 3. 

• /INITIALIZE=CLUSTER_SIZE=n to have DSKINT initialize the disk to the 
specified cluster size. Allowable values for n are 1, 2, 4, 8, 16, 32, and 64. 

• /INITIALIZE=[NO]QUERY to inform DSKINT whether or not to display the 
"Proceed (Y or N)?" prompt. 

If you use more than one argument, enclose them in parentheses and separate 
them with commas. 

/IN_LABEL=label 

Specifies the pack ID of the input disk and provides a means to ensure that you 
are referencing the correct input disk. If the pack ID does not match the one 
found on the specified input disk, BACKUP/COPY displays an error and rejects 
the command. If you do not specify this qualifier, the label is not checked. 
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/[NO]LIST_FILE[=filespec] 

Indicates whether to create a log file that catalogues the sequence of backup 
events. The log contains information about the accounts and files transferred, 
and the disk volumes used. If you do not specify a filespec, the default is /LIST 
FILE=KB:. 

/[NO]OPTIMIZE[=(list)] 

Indicates whether to optimize file cluster sizes, file directories, or both on the 
output disk. The default, /OPTIMIZE, performs both optimizations. 

Use /OPTIMIZE=CLUSTER_SIZE to perform cluster size optimization without 
directory optimization. Likewise, use /OPTIMIZE=DIRECTORY to perform 
directory optimization without performing cluster size optimization. 

/[NO]OUTPUT[=filespec] 

Indicates whether to create a log file that catalogues the sequence of backup 
events and is a synonym for /[NO]LIST_FILE. The log contains information about 
the accounts and files transferred, and the disk volumes used. If you do not 
specify a filespec, the information is sent to your terminal. 

/OUT_LABEL=label 

Specifies the desired name for the output volume ID. The resultant name can 
vary depending on the interaction between /OUTJLABEL and /[NOJINITIALIZE. 

Table 16-2 summarizes the possible outcomes of the interaction of /OUT LABEL 
and /[NOJINITIALIZE during BACKUP. 

Table 16-2: /INITIALIZE and /OUT LABEL Interaction During BACKUP/COPY 
Qualifiers 

Specified Output Volume ID 

The specified name. 

The specified name; however, the operation is only 
successful if the output volume label has the same name. 

BACKUP supplies the name 'BACKUP”. 

The name is unchanged. 


/UU l LABEL=name 

/INITIALIZE 

/OUT_LABEL=name 

/NOINITIALIZE 

/INITIALIZE 

(only) 

/NOINITIALIZE 




/PLACED_POSITION=position 

Indicates where to position files that you are transferring and are marked as 
placed; the position can be: 


INDEX 


Places files near the master file index on the output disk (recom¬ 
mended location). 


MIDDLE Places files at the logical center of the output disk. 

ORIGINAL Places files at or after their location on the input disk. Generally, 

you should not use ORIGINAL when transferring placed files to 
an output disk whose size is different than the input disk. 

The default is /PLACED_POSITION=INDEX. 


/[NOJPROMPT 

Indicates whether to prompt before beginning the BACKUP/COPY operation The 
default is /PROMPT. 
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/[ NOJQUERY 

Indicates whether to prompt before transferring each file selected. Specifying 
/QUERY displays the name of each file selected and asks if you want to copy that 
file. Answer Y or YES to copy the file displayed, or N or NO to skip the file and 
continue with the next file. 

If you respond YES/ALL to the prompt, all remaining selected files are copied 
without prompting. If you respond NO/ALL to the prompt, all remaining selected 
files are skipped and no prompt is displayed. 

The default, /NOQUERY, copies each file selected without prompting. 

/[NO]REPLACE[=QUERY] 

Indicates what action should be taken if a file to be transferred already exists 
on the output disk. If you specify /REPLACE, then BACKUP/COPY replaces 
the file if it exists; any existing file is deleted. If you specify /NOREPLACE, 
BACKUP/COPY issues a warning and does not replace the file if it already exists. 

The default, /REPLACE=QUERY, prompts you to replace any file that already 
exists. Answer Y or YES to replace the current file. Answer N or NO to not 
replace the existing file and proceed with the next file. 

If you respond YES/ALL to the prompt, all remaining selected files are copied 
and replace existing copies without prompting. If you respond NO/ALL to the 
prompt, all remaining selected files are copied except those that already exist on 
the output disk, and there is no further prompting. 

/[NO]VERIFY[=ONLY] 

Indicates whether to verify all of the data transferred to the output disk. If you 
specify /VERIFY, BACKUP/COPY performs a second pass through the input 
disk, comparing each account and file transferred with that on the output disk. 
BACKUP/COPY reports any differences found. /VERIFY=ONLY causes the verify 
only pass to be made over the same input and output specifications used for the 
backup pass. You can use /VERIFY=ONLY to compare the contents of a backup 
set with the source disk to determine what files have changed since the backup 
set was created. You can also use this qualifier to verify several backup sets on 
one tape without having to wait for the tape to rewind after each backup set. 

The default is /NOVERIFY 

Examples 

1 * $ BACKUP/COPY HELP$:*.* DU1: 

This command transfers all the files in the HELP$: account [0,2] on the 
system disk to account [0,2] on DU1:. 
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16.3,3 BACKUP/DIRECTORY Command 


Allows you to list files contained in an existing backup saveset. 
BACKUP/DIRECTORY prompts with: 

Please mount volume 1 of Backup set backup-set-name 
Where can this volume be located <default >? 

At the prompt, enter the device name where the saveset is located. The default is 
the output device you specified in the BACKUP/DIRECTORY command line. 

Privileges required: 

• Read access to the backup set 

• INSTAL to exceed system dynamic region limit 

• TUNE to use the /BUFFER_SIZE qualifier 


Format 

BACKUP/DIRECTORY 

Command Qualifiers 
/[NO] ASS 1ST 
/BRIEF 

/BUFFER_SIZE=value 

/CREATED=date:time 

/MODIFIED=date:time 

/END=action 

/EXCLUDE=(filespec-list) 

/FULL 

/INCLUDE=(filespec-list) 

/IN_LABEL=name 

/[NO]LIST_FILE[=filespec] 

/OCCURRENCE=number 

/[NO]OUTPUT[=filespec] 

/[NO]PROMPT 

/[NOJREWIND 

/SELECT=(filespec-list) 


backup-set 

Defaults 
/NO ASS 1ST 
/BRIEF 

See discussion 
See discussion 
See discussion 
/END=DISMOUNT for disks 
/END=NOREWIND for tapes 
No files excluded 
/BRIEF 

No files included 
Volume ID is not checked 
Your terminal 
First occurrence 
your terminal 
/PROMPT 
NOREWIND 
All files 


Command Parameters 

backup-set 

Identifies the Backup set for which you want to obtain a directory listing. The 
Backup set specification should be a standard RSTS/E device specification. The 
default device is SY:, the default PPN is the user’s current account and the 
default file type is .BCK. 
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Command Qualifiers 

/[NO]ASSIST 

If you specify the /ASSIST qualifier, all prompts for mounting output media, and 
all responses to those prompts, are routed through OMS to the operator. /ASSIST 
is useful when running from a .COM file. 

To receive and answer prompts through OMS, use the DCL command SET 
TERMINAL/OPERATOR. List file information and other output not requiring 
user response are not sent to OMS, but go where they normally go. The default is 
/NOASSIST. 

/BRIEF 

Displays a format similar to the DCL full directory (minus file attributes) and is 
the default qualifier. 

/BUFFER_SIZE=value 

The /BUFFERJ3IZE qualifier controls the size of the dynamic region used 
by BACKUP/DIRECTORY. The valid range is 3 to 255. You can also use the 
keywords OPTIMUM and MAXIMUM. The value represents the number of 
K-words of memory to be used by BACKUP/DIRECTORY as buffer space. 

In general, the larger the value, the faster BACKUP/DIRECTORY performs. 
However, large numbers increase the system loading and resource usage, and can 
seriously impact other users. 

If you omit /BUFFER_SIZE, BACKUP/DIRECTORY uses the minimum buffer 
space consistent with the other qualifiers, or a value of 55 for MU: and MS: de¬ 
vices. If the amount of memory requested is not available, BACKUP/DIRECTORY 
uses as much memory as possible and displays an informational message. If you 
specify MAXIMUM, BACKUP/DIRECTORY uses a value of 255 or as much 
available memory as possible without displaying any message. 

If you specify OPTIMUM, BACKUP/DIRECTORY uses a value of 55. 

/CREATED=(date:time) 

/MODIFIED=(date:time) 

The /CREATED and /MODIFIED qualifiers let you select the files included in 
the directory listing, as chosen by the file specification criteria, based on the 
creation date/time and/or revision date. If no file specification criteria exist, 
these qualifiers apply to all files on the volume for this operation. You can 
use /CREATED and /MODIFIED in conjunction with each other; they are not 
mutually exclusive. To be selected, a file has to satisfy all the criteria you specify. 

You can specify an exact date or range of dates for either qualifier. In the range 
format, each qualifier must take an argument of one or both of the subqualifiers 
BEFORE or AFTER. The subqualifier order in the argument is immaterial. 

The date-time argument is of the standard form (for example, dd-mmm-yy or 
yy.mm.dd and hh:mm A/PM or hh:mm). You must specify the date. If you do not 
specify the time, it defaults to 00:00. In addition, if you specify the time, you 
must separate it from the date by a colon (:). 

The following generic terms can be used in the subqualifier: 

• TODAY—meaning 00:00 on the current (system) date 

• YESTERDAY—meaning 00:00 on the date previous to the current date 

When used with /CREATED, the generic terms also accept a time argument. 
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If you do not specify either /CREATED or /MODIFIED, BACKUP/DIRECTORY 
lists all specified files. 


NOTE 

Files transferred during the backup operation retain their original 
creation and revision dates (that is, the dates on the source volume). 

You need the DATES privilege to keep these original dates; otherwise, 
RSTS/E lists the current date as the creation date of the backed-up file. 

/END=action 

Specifies the disposition of the tape or disk drive at the end of the directory 
listing operation. 

For tapes you can specify /[NOJREWIND. /REWIND rewinds the tape at the end 
of the directory listing operation. 

For disks you can specify /[NOJDISMOUNT. The default is /DISMOUNT, which 
logically dismounts the disk drive at the end of the directory listing operation. 

/EXCLUDE=(filespec-list) 

Lets you specify files that you want excluded from the BACKUP/directory oper¬ 
ation (for example, [0,1]SWAP?.SYS). You can include a list of file specifications 
in the command line up to the maximum length of a DCL command line. The 
default is that no files are excluded. 

/FULL 

Displays detailed information for each file on multiple lines. 

To display information for specific files use /SELECT or /EXCLUDE with 
BACKUP/DIRECTORY. 

/INCLUDE=(filespec-list) 

Lets you specify files or accounts that you want to be unconditionally listed. You 
can include a list of file specifications in the command line up to the maximum 
length of a DCL command line. 

Files in this set override those excluded with the /EXCLUDE qualifier. 

/IN_LABEL=name 

Specifies the name to be compared to the source volume ID. If you use 
this qualifier, the source volume ID must equal the specified name before 
BACKUP/DIRECTORY can perform the requested operation. 

/[NO]LIST_FILE[=filespec] 

Controls the production of a directory-like listing file that catalogues the sequence 
of events in the BACKUP/DIRECTORY operation. The file specification can be 
any valid RSTS/E file specification (wildcards are not allowed). The default is 
your terminal (KB:). 

You can use this qualifier to produce a listing of files in the Backup set. 

/OCCURRENCE=number 

Specifies the occurrence of the named backup set used in the BACKUP process. 
The default is the first occurrence. 

/[NO]OUTPUT[=filespec] 

Controls the production of a directory-like listing file that catalogues the sequence 
of events in the BACKUP/DIRECTORY operation. The file specification can 
be any valid RSTS/E file specification (wildcards are not allowed). You can use 
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this qualifier to produce a listing of files in the Backup set. /NOOUTPUT is a 
synonym for /NOLIST_FILE. The default is your terminal (KB:). 

/[NO]PROMPT 

For each BACKUP/DIRECTORY operation, the Backup utility normally, issues 
a MOUNT prompt even if the Backup set’s device is already mounted. You can 
eliminate the prompt for the first volume by including the /NOPROMPT qualifier 
in your command line. The default is /PROMPT. 

/[ NOJREWIND 

For tape backup files, indicates whether to rewind the tape before searching for 
the logical end of tape. The default is /NOREWIND. 

/SELECT=(filespec-list) 

Specifies the files you want to list. The default is to list all files in the backup set. 
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16,3,4 BACKUP/IMAGE Command 


Asynchronously copies a file-structured RSTS/E disk to a newly initialized disk. 
BACKUP/IMAGE copies all accounts and files from the input disk to the output 
disk. The output disk is bootable if the file [0,1]INIT.SYS is copied and if the 
input disk was bootable. 

Asynchronous operations can degrade the performance of other jobs on your 
system. However, you can improve the performance of other jobs while 
BACKUP/IMAGE is running. Use the following recommendations to improve 
overall system performance: 

• Use /BUFFER_SIZE=MINIMUM. This restricts the amount of asynchronous 
I/O that BACKUP/IMAGE can initiate with the RSTS/E monitor. 

• Lower the job priority of BACKUP/IMAGE. 

• Lower the job runburst for BACKUP/IMAGE to one. For many systems, this 
will have the most noticeable positive effect. 

If you want to increase the performance of BACKUP/IMAGE at the expense of 
overall system performance, use the following recommendations: 

• Use /BLOCK_SIZE=MAXIMUM. 

• Using large buffers reduces the number of I/O requests BACKUP/IMAGE 
has to issue to complete data read and write operations. Digital recommends 
that you not use large block sizes when using small buffer sizes because 
BACKUP/IMAGE would then spend much time waiting for buffers to be¬ 
come available. For example, if you use a block size of 8192 bytes and a 
buffer size of 8 Kwords, BACKUP/IMAGE has just two buffers to work with. 
Use the following formula to calculate the number of buffers available to 
BACKUP/IMAGE: 


BUFFERS= 


BUFFER SIZE * 2048 
BLOCK SIZE 


• Use /BUFFERJSIZE=MAXIMUM. This allows BACKUP/IMAGE to queue as 
much simultaneously I/O as possible. 

• Use the LOAD/INDEX command for the output disk. This speeds processing 
for slower disks such as flexible diskettes, 

Privileges required. 

• Read access to source file-specs 

• Create access to output file-specs 

• DATES to preserve file creation/access dates 

• INSTAL to exceed system dynamic region limit 

• RDNFS, WRTNFS, and SYSMOD to make the output disk bootable. 

• SYSIO to transfer files to account [0,1] 

• TUNE to use /BUFFERJ3IZE qualifier 
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Format 


BACKUP/IMAGE source-disk: output-disk 


Command Qualifiers 

/[NOJASSIST 

/BLOCK_SIZE=value 

/BUFFER_SIZE=value 

/END=[NO]DISMOUNT 

/[NO] IN ITI ALIZE=(condition[,...]) 

/IN_LABEL=label 

/[NO]LIST_FILE[=filespec] 

/[NO]OPTIMIZE=(list) 

/[NO]OUTPUT[=filespec] 

/OUT_LABEL=label 

/PLACED_POSITION=position 

/[NOJPROMPT 

/[NO]REPLACE[=QUERY] 

/[NO]VERIFY[=ONLY] 


Defaults 
NOASSIST 
28672 for disks 
See discussion 
/END=DISMOUNT 
/NOINITIALIZE 
Not checked 
/LIST_FILE=KB: 

/OPTIMIZE 

Your terminal 

Not checked or is in-label 

if you use /INITIALIZE 

/PLACED_POSITION=INDEX. 

/PROMPT 

/REPLACE=QUERY 

/NOVERIFY 


Command Parameters 

source-disk: 

Specifies the input disk, which must be a RSTS/E file-structured disk and it must 
be mounted so that the current job has read access to all the files. The input disk 
can be the system disk or any public or private disk. 

output-disk 

Specifies the output disk, which must be already initialized or a disk that 
BACKUP/IMAGE can initialize. 

Command Qualifiers 

/[NOJASSIST 

If you specify the /ASSIST qualifier, all prompts for mounting output media, and 
all responses to those prompts, are routed through OMS to the operator. /ASSIST 
is useful when running from a .COM file. 

To receive and answer prompts through OMS, use the DCL command SET 
TERMINAL/OPERATOR. List file information and other output not requiring 
user response are not sent to OMS, but go where they normally go. The default is 
/NOASSIST. 

/BLOCK_SIZE=value 

The /BLOCK_SIZE qualifier lets you select the block size used for the file transfer 
operation. You must specify the value argument. Value can be in the range 2048 
to 28672 bytes for disks. Further, the value must be a multiple of 512. You can 
also specify the keywords MINIMUM and MAXIMUM. 
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If you do not specify /BLOCK_SIZE, BACKUP/IMAGE uses 28672 bytes. 

NOTE 

Use of this qualifier can affect the performance of BACKUP/IMAGE. If 
you use large values, BACKUP/IMAGE operates faster. 

/BUFFER_SIZE=value 

The /BUFFER_SIZE qualifier controls the size of the dynamic region used by 
BACKUP/IMAGE. The valid range is 3 to 255. You can also use the keywords 
OPTIMUM and MAXIMUM. The value represents the number of K-words of 
memory to be used by BACKUP/IMAGE as buffer space. In general, the larger 
the value, the faster BACKUP/IMAGE performs. However, large numbers 
increase the system loading and resource usage, and can seriously impact other 
users. 

If you omit /BUFFERJ3IZE, BACKUP/IMAGE uses the minimum buffer space 
consistent with the other qualifiers, or a value of 55 for MU: and MS: devices. If 
the amount of memory requested is not available, BACKUP/DIRECTORY uses as 
much memory as possible and displays an informational message. If you specify 
MAXIMUM, BACKUP/IMAGE uses a value of 255 or as much available memory 
as possible without displaying any message. 

If you specify OPTIMUM, BACKUP/IMAGE uses a value of 55. 

/END=[NO]DISMOUNT 

Indicates whether or not you want the output disk logically dismounted at the 
end of the operation. The default is /END=DISMOUNT. 

/[NO]INITIALIZE=(condition[,...]) 

Indicates whether to initialize the output disk before transferring accounts or 
files. You must use this qualifier if the output disk is a new disk or one without a 
RSTS/E file structure. 

If you specify /INITIALIZE, the output disk will be initialized based on the 
attributes (pack ID, pack cluster size, etc.) of the input disk. Use the /OUT_ 
LABEL qualifier to specify a different pack ID for the output disk. 

You can specify: 

• /INITIALIZE=[NO]ERASE to inform DSKINT whether or not to erase the 
disk. 

• /INITIALIZE=[NO]EXERCISE[=n] to indicate whether or not you want 
DSKINT to exercize the disk. Allowable values for n are 0, 1, 2, and 3. 

• /INITIALIZE=CLUSTER_SIZE=n to have DSKINT initialize the disk the 
specified cluster size. Allowable values for n are 1, 2, 4, 8, 16, 32, and 64. 

• /INITIALIZE=[NO]QUERY to inform DSKINT whether or not to display the 
"Proceed (Y or N)?" prompt. 

If you use more than one argument, enclose them in parentheses and separate 
them with commas. 

/IN_LABEL=label 

Specifies the pack ID of the input disk and provides a means to ensure that you 
are referencing the correct input disk. If the pack ID does not match the one 
found on the specified input disk, then BACKUP/IMAGE displays an error and 
rejects the command. 
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/[NO]LIST_FILE[=filespec] 

Indicates whether to create a log file that catalogues the sequence of backup 
events. The log contains information about the accounts and files transferred, 
and the disk volumes used. 

/[NO]OPTIMIZE=(list) 

Indicates whether to optimize file cluster sizes, file directories, or both on the 
output disk. The default, /OPTIMIZE, performs both optimizations. 

Use /OPTIMIZE=CLUSTER_SIZE to perform cluster size optimization without 
directory optimization. Likewise, use /OPTIMIZE=DIRECTORY to perform 
directory optimization without performing cluster size optimization. 

/[NO]OUTPUT[=filespec] 

Indicates whether to create a log file that catalogues the sequence of backup 
events and is a synonym for /[NO]LIST_FILE. The log contains information about 
the accounts and files transferred, and the disk volumes used. If you do not 
specify a filespec, the log file is displayed on your terminal. 

/OUT__LABEL=label 

Specifies the desired name for the output volume ID. The resultant name can 
vary depending on the interaction between /OUTJLABEL and /[NOJINITIALIZE. 

Table 16—3 summarizes the possible outcomes of the interaction of /OUTJLABEL 
and /[NOJINITIALIZE during BACKUP/IMAGE. 


Table 16-3: /INITIALIZE and /OUT_LABEL Interaction During BACKUP/IMAGE 


Qualifiers 

Specified 

Output Volume ID 

/OUT_LABEL=name 

/INITIALIZE 

The specified name. 

/OUT_LABEL=name 

/NOINITIALIZE 

The specified name; however, the operation is only 
successful if the output volume label has the same name. 

/INITIALIZE 

(only) 

BACKUP supplies the name "BACKUP”. 

/NOINITIALIZE 

(only) 

The name is unchanged. 


/PLACED_POSITION=position 

Indicates where to position files that you are transferring and are marked as 
placed; the position can be: 

INDEX Place files near the master file index on the output disk (recom¬ 

mended location). 

Place files at the logical center of the output disk. 

Places files at or after their location on the input disk. Generally, 
you should not use ORIGINAL when transferring placed files to 
an output disk whose size is different than the input disk. 

The default is /PLACED_POSITION=INDEX. 

/[ NOJPROMPT 

Normally, the Backup utility issues a MOUNT prompt, for each BACKUP/IMAGE 
operation even if the Backup set’s device is already mounted. You can eliminate 
the prompt for the first volume by including the /NOPROMPT qualifier in your 
command line. The default is /PROMPT. 


MIDDLE 

ORIGINAL 


Backing Up and Restoring Files 16-25 






/[NO]REPLACE[=QUERY] 

Indicates what action should be taken if a file to be transferred already exists 
on the output disk. If you specify /REPLACE, then BACKUP/IMAGE replaces 
the file if it exists; any existing file is deleted. If you specify /NOREPLACE, 
BACKUP/IMAGE issues a warning and does not replace the file if it already 
exists. 

The default, /REPLACE=QUERY, prompts you to replace any file that already 
exists. Answer Y or YES to replace the current file. Answer N or NO to not 
replace the existing file and proceed with the next file. 

If you respond YES/ALL to the prompt, all remaining selected files are copied 
and replace existing copies without prompting. If you respond NO/ALL to the 
prompt, all remaining selected files are copied except those that already exist on 
the output disk, and there is no further prompting. 

/[NO]VERIFY[=ONLY] 

The /VERIFY qualifier specifies that a comparison operation is to be performed 
on all data transferred. This postprocess verification reports the presence of any 
data differences. For any differences found, BACKUP/IMAGE displays the PPN, 
file name, and file type at the user’s terminal. /VERIFY=ONLY causes the verify 
only pass to be made over the same input and output specifications used for the 
backup pass. You can use /VERIFY=ONLY to compare the contents of a backup 
set with the source disk to determine what files have changed since the backup 
set was created. You can also use this qualifier to verify several backup sets on 
one tape without having to wait for the tape to rewind after each backup set. 

The default is /NOVERIFY. 

Examples 

1 * $ BACKUP/IMAGE SY: DU1: - 

/INITIALIZE=(ERASE,NOEXERCISE,CLUSTERSIZE=8) - 
/BUFFER_SIZE=MAXIMUM - 
/ BLOCK__S I ZE=MAXIMUM - 
/VERIFY 

Please mount image output volume: 

Press RETURN when ready: 

This disk pack appears to be a RSTS/E formatted 
disk with the following characteristics: 

Pack ID : IMAGE 

Pack Cluster Size : 8 

Pack is currently : Private, 

Update access date on writes. 

Level: 1.2 
Proceed (Y or N)? Y 
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Writing accounts to image volume 
Account [0, 2] written to volume 1 
Account [ 0, 3] written to volume 1 


Writing placed files to image volume 

File [ 0, 1] RSTS96.SIL written to volume 1 

File [ 0, 1] RSTS97.SIL written to volume 1 


Writing non-placed files to image volume 
File [ 0, 1] CONFIG.SYS written to volume 1 
File [ 0, 1] TEST .DCL written to volume 1 


Hooking the output volume 

Account [ 0, 1] verified against volume 1 

File [ 0, 1] RSTS96.SIL verified against volume 1 

File [ 0, 1] RSTS97.SIL verified against volume 1 

%Verification failure for file data for file [0,1] SWAP1 .SYS 

File [ 0, 1] SWAP1 .SYS verified against volume 1 


Please dismount image output volume 

$ 

This command copies all the data on SY: to DU1:. 
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16.3.5 RESTORE Command 


This command restores a RSTS/E disk or subset thereof from a tape or disk 
Backup set. Once RSTS/E determines the syntactic validity of the command 
specification and issues any warning message relative to either the command or 
the environment, RESTORE prompts with: 

Please mount volume 1 of Backup set backup-set-name Where can this 
volume be located <default>l 

At the prompt, enter the device to use or press Return or Line Feed to accept the 
default value. The default value is the device specified as the input parameter. If 
you specify /NOPROMPT, RESTORE omits the prompt message. 

If you are doing a partial restore, and you know what volume to start with, 
start with that volume (although you may start with any volume). RESTORE 
issues a confirmation message and starts with the volume you specify. Note that 
RESTORE may issue a warning message in this case. 


NOTE 


If you have sufficient privilege and you specified /ACCOUNT_DATA in 
the RESTORE command, and if the Backup set contains accounting 
information, BACKUP creates accounts if they did not previously exist. 
The account characteristics are the same as they were for the Backup 
set accounts. If the account already exists, BACKUP replaces the 
existing account characteristics. 

Use RECOVR.COM or the latest installation kit to reboot the system 
before you restore system disks. 

Privileges required: 

• Read access to the backup set 

• Create access to the restored file-specs 

• DATES to preserve file creation/access dates 

• INSTAL to exceed the system dynamic region limit 

• TUNE to use the /BUFFERJ3IZE qualifier 

• SYSIO to restore files to account [0,1] 

• WACNT or GACNT to use the /ACCOUNT_DATA qualifier 


Format 


R ESTORE backup-set output-file-spec 


Command Qualifiers 
/[NO]ACCOUNT_DATA 
/[NO]ASSIST 


Defaults 

/ACCOUNTDATA 
NOASSIST 
See Discussion 
See discussion 


/BUFFER_SIZE=value 
/CREATED=(date:time) 
/MOD IFIE D=(date :time) 
/END=action 


/END=DISMOUNT 
None excluded 


/EXCLUDE=(filespec-list) 
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/[NO]FILE_DATA 

/INCLUDE=(filespec-list) 

/[NO] IN ITI ALIZE[=(condition[,...])] 

/IN _l_ABEL=name 

/[NO]LIST_FILE[=filespec] 

/OCCURRENCE=number 

/[NO]OPTIMIZE[=(list)] 

/OUT_LABEL=name 

/[NO]OUTPUT[=filespec] 

/PLACED_POSITION=position 

/[NO] PROMPT 

/[NO]QUERY 

/[NO]REPLACE[=QUERY] 

/[NO]REWIND 

/SELECT=(filespec-list) 

/[NO]VERIFY[=ONLY] 

Prompts 

See Discussion 


/FILE_DATA 
None included 
See Discussion 
Volume ID not checked 
/LIST_FILE=KB: 
/OCCURRENCES 
See Discussion 
See Discussion 
Your terminal 

/PLACED_POSITION=INDEX 

/PROMPT 

/NOQUERY 

/REPLACE=QUERY 

/NOREWIND 

See Discussion 

/NOVERIFY 


Command Parameters 

backup-set 

Identifies the device where the first volume of the Backup set is mounted. The 
Backup set specification should be a standard RSTS/E device specification. If 
you do not specify a device, the default is SY:. PPN is optional and defaults 
to the user’s current account. The file specification is optional and defaults 
to BACKUP.BCK. If the restore operation needs more than one volume in the 
Backup set, RESTORE prompts you, or an operator if you specify /ASSIST, for 
subsequent volumes as follows: 

Please dismount volume 1 of Backup set backup-set-name 
Please mount volume 2 of Backup set backup-set-name 
Where can this volume be located <default>l 

output-filespec 

Identifies where to put the files or accounts to be restored. The file specification 
should be a standard RSTS/E file specification. If you do not specify device, the 
default is SY:. The PPN is optional and defaults to the user’s current account. 
You can use wildcards in the PPN. The file specification is optional and defaults 
to *.*. You can use standard wildcards. If you specify a filename but not the 
type, BACKUP assumes a * type. If the filename ends with a period, BACKUP 
assumes a null type. If you specify a file type, you must also specify a filename. 
If you specify a wildcard PPN, RESTORE transfers all selected files to: 

• [*,*] — the same accounts as on the Backup set 

• [n,*] — forces the project number to n, uses the programmer number as on 
the Backup set 

• [*,n] — forces the programmer number to n, uses the project number as on 
the Backup set 
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If the accounts do not exist and you specify /ACCOUNTEDATA, RESTORE creates 
them with the same characteristics as they have on the Backup set, providing you 
have the necessary privilege to create the accounts (GACNT or WACNT). 

Command Qualifiers 

/[NOJACCOUNTDATA 

If you have sufficient privilege (GACNT or WACNT), this qualifier determines 
what level of information from a UFD is restored from a Backup set. 

Use /ACCOUNT_DATA to restore all accounting data that is recorded in the 
Backup set both to existing and to newly created accounts. Use /NOACCOUNT_ 
DATA to inhibit the creation of accounts and restoration of UFD data. The 
default is /ACCOUNTJDATA. 

NOTE 

If an account already exists, RESTORE supersedes the accounting data 
when restoring to the original account. 

/[NO]ASSIST 

If you specify the /ASSIST qualifier, all prompts for mounting input media, and 
all responses to those prompts, are routed through OMS to the operator. /ASSIST 
is useful when running from a .COM file. 

To receive and answer prompts through OMS, use the DCL command SET 
TERMINAL/OPERATOR. List file information and other output not requiring 
user response are not sent to OMS, but go where they normally go. The default is 
/NOASSIST. 

/BUFFER_SIZE=value 

The /BUFFERJ3IZE qualifier controls the size of the dynamic region used 
by RESTORE. The valid range is 3 to 255. You can also use the keywords 
OPTIMUM and MAXIMUM. The value represents the number of K-words of 
memory to be used by RESTORE as buffer space. In general, the larger the 
value, the faster RESTORE performs. However, large numbers increase the 
system loading and resource usage, and can seriously impact other users. 

If you omit /BUFFER_SIZE, RESTORE uses the minimum buffer space consistent 
with the other qualifiers, or a value of 55 for MU: and MS: devices. If the amount 
of memory requested is not available, RESTORE uses as much memory as 
possible and displays an informational message. If you specify MAXIMUM, 
RESTORE uses a value of 255 or as much available memory as possible without 
displaying any message. If you specify OPTIMUM, RESTORE uses a value of 55. 

/CREATED=date:time 

/MODIFIED=date:time 

The /CREATED and /MODIFIED qualifiers let you select the files to be restored, 
as chosen by the file selection criteria (see the output-file-spec description), based 
on the creation dates/times and/or revision dates. If no file selection criteria exist, 
these qualifiers apply to all files on the input volume to which you have access for 
this operation. You can use /CREATED and /MODIFIED in conjunction with each 
other; they are not mutually exclusive. To be selected, a file has to satisfy all the 
criteria you specify. 

You can specify an exact date or a range of dates for either qualifier. In the 
range of dates format, each qualifier must take an argument of one or both of the 
subqualifiers, BEFORE or AFTER. The order of the subqualifiers in the argument 
is immaterial. If you specify both BEFORE and AFTER dates for either one of 
the qualifiers, the AFTER date must be earlier than the BEFORE date. 
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If you do not use either /CREATED or /MODIFIED, all specified files are selected 
for transfer from the Backup set. 


NOTE 

BACKUP retains both the creation and revision dates as they were on 
the source volume for the files transferred if you have DATES privilege. 

/END=action 

REWIND causes the magnetic tape to be rewound to the load point and 
dismounted following successful completion of the RESTORE operation. 
/END=NOREWIND causes the magnetic tape to remain positioned after the 
most recent Backup set. The default is END=NOREWIND. 

If you want the Backup set’s device to remain mounted at the end of the BACKUP 
operation, specify END=NODISMOUNT in the command line. The default is 
END=DISMOUNT. 

/EXCLUDE=(filespec-list) 

Lets you specify files that you want to be excluded from the RESTORE opera¬ 
tion. You can include a list of file specifications in the command line up to the 
maximum length of a DCL command line. 

/[NO]FILE_DATA 

Controls whether file data is transferred during a RESTORE operation. If you 
specify /FILE_DATA, RESTORE transfers the file data from the Backup set to 
the RSTS/E volume. If you specify /NOFILE_DATA, RESTORE proceeds without 
restoring any of the specified files. The default is /FILE_DATA. 

If you have accounting (GACNT, WACNT) privileges, you can use /NOFILE_DATA 
with the /ACCOUNT_DATA qualifier to restore only account information from a 
Backup set. 

/INCLUDE=(filespec-list) 

Lets you specify files that you want to be unconditionally processed. You can 
include a list of file specifications in the command line up to the maximum length 
of a DCL command line. 

Files in this set override those specified with the /EXCLUDE qualifier. 

/[NO]INITIALIZE[=(condition[,...])] 

Specifies the disposition of the output media prior to the data transfer operation. 

The /INITIALIZE qualifier specifies that RESTORE should disregard any file 
structure on the disk and reinitialize the volume with a RSTS/E file structure as 
if it were done with the INITIALIZE command. 

RESTORE takes the characteristics from the source device summary. (If the 
device cluster size of the original volume is too small, the next higher valid 
cluster size is used for the output volume.) 

You can only specify /NOINITIALIZE when the RESTORE operation is from a 
Backup set to an existing RSTS/E disk. In this case, RESTORE places the files 
on the existing file structures instead of replacing them. 

You can specify: 

• /INITIALIZE=[NO]ERASE to inform DSKINT whether or not to erase the 
disk. 

• /INITIALIZE=[NO]EXERCISE[=n] to indicate whether or not you want 
DSKINT to exercize the disk. Allowable values for n are 0, 1, 2, and 3. 
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• /INITIALIZE=CLUSTER_SIZE=n to have DSKINT initialize the disk the 
specified cluster size. Allowable values for n are 1, 2, 4, 8, 16, 32, and 64. 

• /INITIALIZE=[NO]QUERY to inform DSKINT whether or not to display the 
"Proceed (Y or N)?" prompt. 

/IN_LABEL=name 

Specifies the name to be compared to the source volume ID. If you use this qual¬ 
ifier, the source volume ID must equal the specified name before the RESTORE 
operation can be performed. 

/[NO]LIST_FILE[=file-spec] 

Generates a directory-like listing file, cataloguing the sequence of events in 
the RESTORE operation. If you specify /LIST_FILE, you must include the file 
specification. It can be any legal RSTS/E file specification (wildcards are not 
allowed). The default is /LIST_FILE=KB:. 

/OCCURRENCE=number 

Indicates the particular occurrence of a named Backup set to use when more than 
one Backup set of the same name exists on a magnetic tape. You must specify the 
argument which refers to the position relative to either the current tape position 
or the beginning of the tape depending on the use of /[NOJREWIND. 

RSTS/E Backup sets are interchangeable with VAX Backup sets. However, VAX 
Backup set names can be greater than six characters, while RSTS/E looks at 
only the first six characters. Therefore, RSTS/E cannot distinguish between two 
VAX names that have the same first six characters (for example, ABCDEF and 
ABCDEFG). To transfer ABCDEFG, you must use ABCDEF/OCCURRENCE=2. 

The default is /OCCURRENCE=l; the first occurrence of the named Backup set. 

/[NO]OPTIMIZE[=(list)] 

The /[NOJOPTIMIZE qualifier controls how RESTORE optimizes the directory 
structure. Two optimizations are available: 

• DIRECTORY — Directories can be extended to the size they were on the 
original volume. 

• CLUSTER_SIZE — File cluster sizes can be increased to the maximum 
necessary to minimize calls to the file processor. 

The /NOOPTIMIZE qualifier inhibits these optimizations. The /OPTIMIZE 
without an argument selects both optimizations. The default is /OPTIMIZE. 

In general, you would want to perform these optimizations to increase overall 
system performance. However, if there is not much contiguous disk space 
available, you would not want to make all executable files contiguous. Similarly, 
if there is little free disk space, you would not want to optimize cluster sizes 
because this takes more disk space. 

/OUT_LABEL=name 

Specifies the desired name for the output volume ID. The resultant name can 
vary depending on the interaction between /OUT_LABEL and /[NOJINITIALIZE. 

Table 16—4 summarizes the possible outcomes from the interaction of 
/[N0]INITIALIZE and /OUT.LABEL during RESTORE. 
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Table 16-4: /INITIALIZE and /OUT_LABEL Interaction During RESTORE 


Qualifiers Specified 

Output Volume ID 

/OUT_LABEL=name 

/INITIALIZE 

The specified name. 

/OUT_LABEL=name 

/NOINITIALIZE 

The specified name; however, the operation is only 
successful if the output volume label has the same name. 

/INITIALIZE (only) 

The destination volume name is the same as the source 
volume name. 

/NOINITIALIZE (only) 

The name is unchanged. 


/[NO]OUTPUT[=filespec] 

Controls the production of a directory-like listing file that catalogues the sequence 
of events in the RESTORE operation. The file specification can be any valid 
RSTS/E file specification (wildcards are not allowed). You can use this qualifier 
to produce a listing of files in the Backup set. /NOOUTPUT is a synonym for 
/NOLIST_FILE. The default is your terminal (KB:). 

/PLACED_POSITION=position 

Controls the placement of files that were marked as placed on the source disk. 

The /PLACED_POSITION qualifier takes one of the following keyword argu¬ 
ments: 

• INDEX — Place close to the storage allocation table and master file directory 

• MIDDLE — Place close to the middle of the disk 

• ORIGINAL — Place close to the original position on the source disk 

The default is INDEX 

The rules for contiguity apply first and foremost; that is, RESTORE sacrifices 
placement in the interest of contiguity. The first sufficient contiguous space 
closest to the selected position is the first choice for positioning the file on the 
output volume. 

If no contiguous space of sufficient size exists on the output volume, then the first 
clusters) of the file are positioned as close to the original address as possible and 
the remaining clusters are positioned as required. 

/[NO]PROMPT 

Normally, the BACKUP utility issues a MOUNT prompt for each RESTORE 
operation even if the Backup set’s device is already mounted. You can eliminate 
the prompt for the first volume by including the /NOPROMPT qualifier in your 
command line. The default is /PROMPT. 

/[NO]QUERY 

Causes RESTORE to prompt you as to whether each file that meets the selec¬ 
tion criteria should be transferred. A Y[ES] response effects the transfer. A 
response of N[0] or pressing Return bypasses the file. Any other response causes 
RESTORE to reissue the prompt. 

A YES/ALL response causes the current file and all remaining files to be trans¬ 
ferred without any further prompting. A response of NO/ALL causes the current 
file and all remaining files to be bypassed without any further prompting. 

The default is /NOQUERY. 


Backing Up and Restoring Files 16-33 







/[NO]REPLACE[=QUERY] 

Indicates what action should be taken if a file to be transferred already exists 
on the output disk. If you specify /REPLACE, RESTORE replaces the file if it 
exists; any existing file is deleted. If you specify /NOREPLACE, RESTORE issues 
a warning and does not replace the file if it already exists. 

The default, /REPLACE=QUERY, prompts you to replace any file that already 
exists. Answer Y or YES to replace the current file. Answer N or NO to not 
replace the existing file and proceed with the next file. 

If you respond YES/ALL to the prompt, all remaining selected files are copied and 
replace existing copies without prompting. If you respond NO/ALL to the prompt, 
all remaining selected files are copied and do not replace existing files without 
prompting. 

/[NO]REWIND 

Specifies the disposition of a magnetic tape Backup set volume before processing. 
The default is /NOREWIND. 

If you specify /REWIND, the search for the Backup set begins at the beginning 
of the tape. The /NOREWIND qualifier means the search starts at the present 
position. 

If the logical end-of-tape on the volume is found before the desired Backup set, 
the tape is rewound and an error message appears at the terminal. 

/SELECT[=(filespec-list)] 

Lets you select specific files from the input Backup set to be restored. You can use 
the /SELECT qualifier in conjunction with the /EXCLUDE qualifier and/or the 
/INCLUDE qualifier. If you use /SELECT in combination with other qualifiers, 
the file transfer candidates are chosen according to the following steps: 

1. All files on the volume for which the user has read access privilege are 
initially considered. 

2. If you use the /CREATED or /MODIFIED qualifiers, only those files from step 
1 which meet the time bracket criteria are considered. 

3. If you use the /SELECT qualifier, only those files from step 2 that match one 
of the /SELECT file specifications are considered. 

4. If you use the /EXCLUDE qualifier, any files from step 3 that match one of 
the /EXCLUDE file specifications are removed from consideration. 

5. If you use the /INCLUDE qualifier, RESTORE also considers any files 
meeting the inclusion criteria, provided that you have access to them. Note 
that RSTS/E does not consider the /CREATED, /MODIFIED, /SELECT, or 
/EXCLUDE qualifiers when processing the /INCLUDE list. 

/[NO]VERIFY[=ONLY] 

The /VERIFY qualifier specifies that a comparison operation is to be performed on 
all data transferred. This postprocess verification (for multi volume Backup sets, 
all volumes are transferred before any volume is verified) reports the presence 
of any data differences. For any differences found, RESTORE displays the PPN, 
file name, and file type at the user’s terminal. /VERIFY=ONLY causes the verify 
only pass to be made over the same input and output specifications used for 
the backup pass. You can use /VERIFY=ONLY to compare the contents of the 
restored disk with the source disk to determine what files have changed since the 
backup set was created. You can also use this qualifier to verify several backup 
sets on one tape without having to wait for the tape to rewind after each backup 
set. 
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The default is /NOVERIFY. 


Examples 

1 . 

RESTORE/SELECT=[*,*]PAYROL.DAT MTO:PAYROL.BCK DR1:*.* 

This command restores a file from a save set on tape 

2 . 

RESTORE MMO:1409MA.BCK DU1: [*,*]*.* 

This command restores a disk from a save set on tape 

3. 

RESTORE MTO:DAT17M.BCK/SELECT= - 

(PAYROL.DAT,BENEFI.DAT,VACATI.DAT) DR2:[*.*]*.* 

This command restores a list of files from a save set on tape 

4. 

RESTORE/LIST_FILE=928FEB.LOG/ACCOUNT_DATA 
MMO:928FEB.BCK DR1:[*.*]*.* 

This command restores a disk from a save set, and if a file exists, replaces it 
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16.3.6 RESTORE/DIRECTORY Command 


Allows RESTORE to list files within an existing BACKUP saveset. 
RESTORE/DIRECTORY prompts with: 

Please mount volume 1 of Backup set backup-set-name 
Where can this volume be located <default>l 

At the prompt, enter the device name where the saveset is located. The default is 
the output device you specified in the RESTORE/DIRECTORY command line. 

Privileges required: 

• Read access to the backup set 

• INSTAL to exceed the system dynamic region limit 

• TUNE to use the /BUFFERJ3IZE qualifier 


Format 

RESTORE/DIRECTORY 

Command Qualifiers 

/[NO]ASSIST 

/BRIEF 

/BUFFER_SIZE=value 

/CREATED=date:time 

/MODIFIED=date:time 

/END=action 

/EXCLUDE=(filespec-list) 

/FULL 

/INCLUDE=(filespec-list) 

/IN_LABEL=name 

/[NO] LIST_F I LE[=f i lespec] 

/OCCURRENCE=number 

/[NO]OUTPUT[=filespec] 

/[NOJPROMPT 

/[NO]REWIND 

/SELECT=(f ilespec-list) 


backup-set 

Defaults 

/NOASSIST 

/BRIEF 

See discussion 
See discussion 

/END=DISMOUNT for disks 
/END=NOREWIND for tapes 
No files excluded 
/BRIEF 

No files included 
Volume ID is not checked 
Your terminal 
First occurrence 
Your terminal 
/PROMPT 
NOREWIND 
All files 
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Command Parameters 

backup-set 

Identifies the disk or tape that contains the Backup set. The Backup set speci¬ 
fication should be a standard RSTS/E device specification. You must specify the 
device. PPN is optional and defaults to the user’s current account. The file spec¬ 
ification is optional and defaults to BACKUPBCK. If the backup set consists of 
more than one volume, RESTORE/DIRECTORY prompts for subsequent volumes 
as follows: 

Please dismount volume 1 of Backup set backup-set-name 
Please mount volume 2 of Backup set backup-set-name 
Where can this volume be located <default>l 

Command Qualifiers 

/[NO]ASSIST 

If you specify the /ASSIST qualifier, all prompts for mounting the media, and all 
responses to those prompts, are routed through OMS to the operator. /ASSIST is 
useful when running from a .COM file. 

To receive and answer prompts through OMS, use the DCL command SET 
TERMINAL/OPERATOR. List file information and other output not requiring 
user response are not sent to OMS, but go where they normally go. The default is 
/NOASSIST. 

/BRIEF 

Displays a format similar to the DCL full directory (minus file attributes) and is 
the default qualifier. 

/BUFFER_SIZE=value 

The /BUFFERJ3IZE qualifier controls the size of the dynamic region used by 
RESTORE/DIRECTORY. The valid range is 3 to 255. You can also use the 
keywords OPTIMUM and MAXIMUM. The value represents the number of 
K-words of memory to be used by RESTORE/DIRECTORY as buffer space. 

In general, the larger the value, the faster RESTORE/DIRECTORY performs. 
However, large numbers increase the system loading and resource usage, and can 
seriously impact other users. 

If you omit /BUFFERJ3IZE, RESTORE/DIRECTORY uses the minimum 
buffer space consistent with the other qualifiers, or a value of 55 for MU: 
and MS: devices. If the amount of memory requested is not available, 
RESTORE/DIRECTORY uses as much memory as possible and displays an 
informational message. If you specify MAXIMUM, RESTORE/DIRECTORY uses 
a value of 255 or as much available memory as possible without displaying any 
message. 

If you specify OPTIMUM, RESTORE/DIRECTORY uses a value of 55. 

/CREATED=(date:time) 

/MODIFIED=(date:time) 

The /CREATED and /MODIFIED qualifiers let you select the files included in 
the directory listing, as chosen by the file specification criteria, based on the 
creation date/time and/or revision date. If no file specification criteria exist, 
these qualifiers apply to all files on the volume for this operation. You can 
use /CREATED and /MODIFIED in conjunction with each other; they are not 
mutually exclusive. To be selected, a file has to satisfy all the criteria you specify. 

You can specify an exact date or range of dates for either qualifier. In the range 
format, each qualifier must take an argument of one or both of the subqualifiers 
BEFORE or AFTER. The subqualifier order in the argument is immaterial. 
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The date-time argument is of the standard form (for example, dd-mmm-yy or 
yy.mm.dd and hh:mm A/PM or hh:mm). You must specify the date. If you do not 
specify the time, it defaults to 00:00. In addition, if you specify the time, you 
must separate it from the date by a colon (:). 

The following generic terms can be used in the subqualifier: 

• TODAY—meaning 00:00 on the current (system) date 

• YESTERDAY—meaning 00:00 on the date previous to the current date 

When used with /CREATED, the generic terms also accept a time argument. 

If you do not specify either /CREATED or /MODIFIED, RESTORE/DIRECTORY 
lists all specified files. 


NOTE 

Files transferred during the backup operation retain their original 
creation and revision dates (that is, the dates on the source volume). 

You need the DATES privilege to keep these original dates; otherwise, 
RSTS/E lists the current date as the creation date of the backed-up file. 

/END=action 

Specifies the disposition of the tape or disk drive at the end of the directory 
listing operation. 

For tapes, specify /END=[NO]REWIND. /END=REWIND rewinds the tape at the 
end of the directory listing operation. 

For disks, specify /END=[NO]DISMOUNT. The default is /END=DISMOUNT, 
which logically dismounts the disk drive at the end of the directory listing 
operation. 

/EXCLUDE=(filespec-list) 

Lets you specify files that you want excluded from the RESTORE/DIRECTORY 
operation (for example, [0,1]SWAP?.SYS). You can include a list of file specifica¬ 
tions in the command line up to the maximum length of a DCL command line. 
The default is that no files are excluded. 

/FULL 

Displays detailed information for each file on multiple lines. 

To display information for specific files use /CREATED, /MODIFIED, /EXCLUDE, 
/INCLUDE, and /SELECT. 

/INCLUDE=(filespec-list) 

Lets you specify files or accounts that you want to be unconditionally listed. You 
can include a list of file specifications in the command line up to the maximum 
length of a DCL command line. 

Files in this set override those excluded with the /EXCLUDE qualifier. 

/IN_LABEL=name 

Specifies the name to be compared to the backup set volume ID. If you 
use this qualifier, the volume ID must equal the specified name before 
RESTORE/DIRECTORY can perform the requested operation. 

/[NO]LIST_FILE[=filespec] 

Controls the production of a directory-like listing file that catalogues the sequence 
of events in the RESTORE/DIRECTORY operation. The file specification can be 
any valid RSTS/E file specification (wildcards are not allowed). The default is 
your terminal (KB:). 
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You can use this qualifier to produce a listing of files in the Backup set. 

/OCCURRENCE=number 

Specifies the occurrence of the named backup set used in the backup process. The 
default is the first occurrence. 

/[NO]OUTPUT[=filespec] 

Controls the production of a directory-like listing file that catalogues the sequence 
of events in the RESTORE/DIRECTORY operation. The file specification can 
be any valid RSTS/E file specification (wildcards are not allowed). You can use 
this qualifier to produce a listing of files in the Backup set. /NOOUTPUT is a 
synonym for /NOLIST_FILE. The default is your terminal (KB:). 

/[ NOJPROMPT 

Normally, the Restore utility issues a MOUNT prompt, for each 
RESTORE/DIRECTORY operation even if the Backup set's device is already 
mounted. You can eliminate the prompt for the first volume by including the 
/NOPROMPT qualifier in your command line. The default is /PROMPT. 

/[NOJREWIND 

For tape backup files, indicates whether to rewind the tape before searching for 
the logical end of tape. The default is /NOREWIND. 

/SELECT=(filespec-list) 

Specifies the files you want to list. The default is to list all files in the backup set. 
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Chapter 17 


Managing the Operator/Message Services Package 


This chapter describes the Operator/Message Services (OMS) package and the 
DCL commands used to manage the OMS package. Table 17-1 summarizes the 
DCL commands for using OMS. 

NOTE 

OMS is compatible with OPSER and you can operate OSM and OPSER 
concurrently. However, all system programs such as LOGIN and 

LOGOUT that previously sent messages to OPSER now communicate 
with OMS. 

Table 17-1 : OMS Commands 


Package-Related Command 

Description 

SET OPERATORJSERVICES 

SET TERMINAL/OPERATOR.SERVICES 

SHOW OPERATOR_SERVICES 

START/OPERATOR_SERVICES 

STOP/OPERATOR__SERVICES 

Changes the current settings of the OMS package. 

Defines a terminal as an operator terminal allowing it to 
receive messages or requests or both. 

Displays the current status and settings of the OMS 
package. 

Starts the Operator/Message Services package. 

Shuts down the Operator/Message Services package. 

Request-Related Command 

Description 

REPLY 

SHOW REQUESTS 

Replies to or aborts a pending request. 

Displays requests stored in the OMS log file. 



17.1 Overview of Operator/Message Services 


The OMS package provides the following general system functions: 

• Operator Messages and Requests 

A user issues the REQUEST command to send messages to operators 
and include the /REPLY qualifier to indicate that a reply is needed. 
REQUEST/REPLY causes the job to be stalled until an operator replies 
to the request, aborts the request, or the user invokes Ctrl/C to cancel the 
request. The REQUEST/REPLY command can be used to ask an operator 
to mount a disk or tape, to change printer forms, or to simply carry on a 
dialogue with an operator. See the RSTS/E System User's Guide for more 
information about the REQUEST command. 
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• System Messages 

OMS receives event information, such as LOGIN attempts or printer offline 
notices, from various system programs and broadcasts the messages to all 
operator terminals. Operator terminals are those terminals designated to 
receive operator messages or requests or both. If requested to do so, OMS also 
saves the messages in its log file for later display (via the SHOW REQUESTS 
command). 

• Disk and Tape Mounting 

In conjunction with a DCL command procedure, OMS provides operator 
assistance for mounting disks and tapes. This feature is especially useful 
when media are stored in a remote computer room and the specific disk or 
tape drive is unknown by the user issuing the command. 

• BACKUP and RESTORE 

OMS provides support for mounting disks or tapes as part of a BACKUP 
or RESTORE operation. This allows backups and restores to be performed 
under BATCH, because requests for mounting additional disk or tape volumes 
are issued as operator requests instead of user prompts. 

• DCL Command Procedures 

DCL command procedures can be designed to issue operator requests and 
receive the operator’s reply in a DCL symbol for further analysis and 
processing. 


17.1.1 The OMS Work File 

OMS stores package information and pending requests in the OMS work file. 
This file (OMS.SYS) is located in the OMS package location _SY:[0,20] and is 
pointed to by the system logical OMS$. You can relocate the OMS package if 
desired. 


17.1.2 The OMS Log File 

OMS saves messages or requests or both in the OMS log file. This file 
(REQLOG.OMS) is located in the OMS package location _SY:[0,20] and pointed to 
by the system logical OMS$. 


NOTE 

This file is NOT an ASCII format file, therefore you cannot use TYPE 
or PRINT. Requests are stored in an internal format and can only be 
displayed properly by using the SHOW REQUESTS command. 

Each message and request in the OMS log file is assigned a 4-digit ID number. 
Similarly as you do for Print and Batch queue entries, you access a specific 
message or request by ID number Each time you start OMS or when the 
maximum request ID number is reached, OMS begins renumbering new messages 
and requests, starting with ID number 1. 

NOTE 

OMS will not assign a new request the same ID number as a currently 
pending request. Instead, OMS will go to the next available ID number. 
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17.1.3 Operator Messages and Requests 

Operator messages and requests are broadcast to all operator terminals. A termi¬ 
nal is designated as an operator terminal via the SET TERMINAL/OPERATOR_ 
SERVICES command. Operator terminals can receive messages or requests or 
both even when they are logged out. Any number of terminals can be designated 
as operator terminals. 

NOTE 

OMS makes heavy use of the Set /Read Terminal Characteristics SYS 
Call. You can increase performance of the OMS package by keeping 
the terminal overlay loaded with the LOAD/OVERLAY command. See 
Chapter 14 for more information about the LOAD/OVERLAY command. 

Operator messages and requests can also be saved in the OMS log file and 
displayed at any time using the SHOW REQUESTS command. 

Pending requests (requests that are awaiting an operator reply) are rebroadcast 
periodically to all operator terminals using an increasing interval scale, ranging 
from six minutes to one hour. 


17.1.4 System Messages 

OMS receives messages sent to it by various system utilities, such as LOGIN, 
LOGOUT, and PBS. These messages may represent normal system events, such 
as a user logging in to the system or PBS completion of a print job, or it may 
indicate an event that requires operator action, such as a PBS printer going 
offline. 

User applications also send event messages to OMS. Doing so provides an easy 
way to log system activity beyond those events generated by RSTS/E software. 
For example, a general accounting package may want to notify OMS when its 
end-of-month processing is complete. Facility names make it easy to group 
and display messages of the same type. OMS handles the dispatching of these 
messages, broadcasting them to all defined operator terminals, and recording 
them in the OMS log file for later display (via the SHOW REQUESTS command). 

One special message is the OMS timestamp message. Once each day (at midnight, 
or when the date changes via a SET TIME command), OMS enters a timestamp 
message into the OMS log file if /KEEP=MESSAGES is enabled. This aids in 
the examination of the SHOW REQUESTS output. Unlike other OMS messages, 
timestamp messages are recorded in the log file but are not broadcast to operator 
terminals. 

If OMS is not installed on the system or is not running when a message is sent to 
it, an error is returned to the sending program. Except for LOGIN and LOGOUT, 
RSTS/E utilities discard any messages that they cannot deliver to OMS. For 
security purposes, LOGIN and LOGOUT broadcast their messages to the system 
console (_KB0:) if they are unable to send them to OMS. 


17.1.5 Displaying Messages and Requests 

OMS saves all messages and requests in its log file. Information is not lost 
because it scrolls off the screen or because no operator terminal is enabled. 
Use the SHOW REQUESTS command to display messages or requests or both, 
including replies to requests. 
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Include the /OUTPUT qualifier to write the display to a file for later examination. 
You can also include the /INPUT qualifier to select one or more archived OM& log 
files. 

You can select messages or requests or both for display based on one or more of 
the following criteria: 

• Request type (/REPLY) 

• Facility name (/FACILITY) 

• Date and time (/BEFORE and /SINCE) 

• Job number (/JOB) 

• User account (/USER) 

• Terminal number (/TERMINAL) 

• Message text (/TEXT and /EXACT) 


17.1.6 Archiving OMS Log Files 

Each message or request added to the OMS log file increases the size of the file 
as well as the time needed to perform a SHOW REQUESTS command. You may 
want to periodically save the current OMS log file and start a new one. 

The /INPUT qualifier of the SHOW REQUESTS command allows you to specify 
an alternate log file (including wildcard filespecs) for displaying messages and 
requests. This allows you to examine archived OMS log files as necessary. 

Digital recommends the following process for archiving OMS log files: 

1. Use the STOP/OPERATOR_SERVICES command to ensure that OMS is not 
adding records to its log file. 

2. RENAME the OMS log file or COPY to a new location or both. 

3. Use the START/OPERATORJ3ERVICES command to start OMS. This creates 
a new OMS log file. See Section 17.1.8 for a description of how the template 
startup procedure uses the current date to rename the OMS log file before 
starting OMS. 


17.1.7 Facility Names 

The SHOW REQUESTS command includes a /FACILITY qualifier to select 
messages based on a specified facility name. This allows you to display messages 
and requests sent from the same program or facility. 

A facility name is a keyword, up to 6 characters, identifying the program or 
application that issued a request or message. Whenever a program sends a 
message or request to OMS, it includes a facility name that is saved with the 
message or request. Certain RSTS/E facilities use predefined facility names, like 
LOGIN, LOGOUT, and BACKUP. You can define your own facility names for any 
application or program that sends messages or requests to OMS. 

Table 17—2 lists the facility names reserved by RSTS/E and their associated 
programs. 
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Table 17-2: Reserved Facility Names 


Name 

Facility 

BACKUP 

BACKUP/RESTORE facility 

LOGIN 

LOGIN program 

LOGOUT 

LOGOUT program 

OMS 

Operator/Message Services 

PBS 

Print/Batch Services 

USER 

DCL REQUEST command 


Programs can use any facility name when sending messages or requests to OMS, 
including the ones reserved for use by RSTS/E. However, avoid using the reserved 
facility names or any facility name starting with NO. This prevents conflicts with 
the RSTS/E facilities and the keywords used to select and exclude facilities on the 
SHOW REQUESTS command. 


17.1.8 Starting OMS 

When OMS is started with the START/OPERATOR_SERVICES command, a 
detached job is created to run OMS. Include the /PRIORITY and /RUN_BURST 
qualifiers to specify the run-burst and priority for the OMS job. You can also 
include the /KEEP qualifier to indicate whether messages or requests or both 
should be stored in the OMS log file. 

The template system startup procedure ([0,1JSTART.COM) provided with V10.0 
and higher performs the following steps to start OMS: 

1. Renames the current OMS log file to another name based on the current 
date. This keeps the size of the current log file relatively small and allows 
easy archival of past log files. The file name has the format ‘Vymmdd.OMS,’* 
where ‘yy* represents the current year, ‘mm’ is the current month, and ‘dd’ is 
the current day. If a file already exists with the current name, the rename 
does not take place and OMS appends new requests to the end of the current 
OMS log file. 

2. Defines _KB0: (the system console) as an operator terminal. Add the nec¬ 
essary SET TERMINAL/OPERATORJ3ERVICES/PERMANENT commands 
to define other operator terminals on your system. Each operator terminal 
can be defined to receive messages only, requests only, or both messages and 
requests. 

The following command examples can be used to set up operator terminals in 
your START.COM file: 

$ SET TERMINAL _KB24:/PERMANENT/OPERATOR=(MESSAGES,NOREQUESTS) 

$ !Set KB24 to receive OMS messages only 

$ SET TERMINAL _KB25:/PERMANENT/OPERATOR=(NOMESSAGES,REQUESTS) 

$ !Set KB25 to receive OMS requests only 

$ SET TERMINAL __KB26:/PERMANENT/OPERATOR_SERVICES 

$ !Set KB26 to receive OMS messages and requests (default) 

3. Issues the START/OPERATOR_SERVICES command to start OMS. If no 
work file exists at startup, OMS creates one with the default /KEEP setting 
of ALL. Otherwise, OMS uses the last /KEEP value specified. 
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OMS then opens the OMS log file, creating it if necessary. A starting OMS 
message is broadcast to all operator terminals set to receive messages and 
stored in the log file if/KEEP=MESSAGES is enabled. 


17.1.9 Stopping OMS 

The STOP/OPERATOR__SERVICES command is used to shut down the OMS 
package. OMS will not accept any new requests while processing a STOP 
command. Use the /ABORT qualifier to stop OMS as soon as possible by aborting 
any pending requests. Use the /NOABORT qualifier to allow any pending 
requests to be answered or aborted by an operator before shutting down OMS. 
The default is /NOABORT. 

The SHUTUP program shuts down OMS as part of its normal shutdown process¬ 
ing. SHUTUP uses /ABORT to delete any pending requests. Any jobs awaiting 
operator replies have already been removed. 


17.2 DCL Command Descriptions 

The following section contains descriptions of the OMS commands that re¬ 
quire special privileges. See the RSTS/E System User's Guide for a complete 
description of the REQUEST command. 


17.2.1 REPLY Command 


This command responds to a pending user or application request. The operator 
can complete the request, abort the request, or answer the request while keeping 
the request pending. REPLY requires OPER privilege. 


Format 


REPLY [["]message-text["]] 


Command Qualifiers 

Defaults 

/ABORT=identification-number 

None 

/ANSWER=identification-number 

None 

/DISABLE 

None 

/ENABLE 

None 

/PENDING=identification-number 

None 

/PROMPT 

None 

/STATUS 

None 

U 0=identif ication-number 

None 
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Command Parameters 


[[ M ]message-text[ M ]] 

Specifies the text of the reply. Specifying the reply text on the command line 
imposes a limit of 255 characters for the entire command. The text must be 
enclosed in quotation marks if it contains spaces, special characters, or lowercase 
characters. The /PROMPT qualifier can be used instead to allow the user to be 
prompted for each line of the reply similarly to the CREATE and BROADCAST 
commands. 

Command Qualifiers 

/ABORT=identification-number 

Answers the request from a user or application corresponding to the unique 
identification number and aborts the request. For the REQUEST command, the 
user who issued the request receives an error message. For an application, the 
program receives the reply text and a flag indicating that /ABORT was specified. 

/ANSWER=identification-number 

Answers the request from a user or application corresponding to the unique 
identification number and successfully completes the request. 

/DISABLE 

Indicates that the terminal will not perform as an operator services console. 
REPLY/DISABLE is a synonym for the SET TERMINAL/NOOPERATOR. 
SERVICES command and is provided for VMS compatibility. 

/ENABLE 

Indicates that the terminal is enabled as an operator services console. 
REPLY/ENABLE is a synonym for the SET TERMINAL/OPERATOR.. 
SERVICES=ALL command and is provided for VMS compatibility. 

/PENDING=identification-number 

Answers the request from a user or application corresponding to the unique 
identification number and leaves the request pending. The job which issued the 
request is kept in a wait state and the user cannot enter other commands until 
the operator completes or aborts the request. 

/PROMPT 

Prompts the user for multiple lines of text that make up the reply. The reply is 
entered similarly to the CREATE and BROADCAST commands. By using this 
qualifier, the length of the reply text can have a maximum of 500 characters. 

This qualifier conflicts with the reply-text parameter and causes an error if both 
are specified in a command. 

/STATUS 

Displays the pending requests from the operator work file. 

/TO=identification-number 

Answers the request from a user or application corresponding to the unique 
identification number and successfully completes the request. This is a synonym 
for the /ANSWER qualifier and is provided for VMS compatibility. 
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17.2.2 SET OPERATOR_SERVICES Command 


This command changes the settings of the OMS package. Use this command to 
specify whether messages or requests or both are stored in the OMS log file. SET 
OPERATOR_SERVICES requires SWCFG and OPER privileges. 


Format 

SET OPERATOR SERVICES 

Command Qualifiers Default 

/[NO]KEEP[=(keyword[,...])] /KEEP=ALL 


Command Qualifiers 

/KEEP[=(keyword[,...])] 

Specifies what items, if any, are stored in the OMS log file. Valid keywords are 
ALL, [NO]MESSAGES, [NOJREQUESTS, and NONE. MESSAGES are requests 
made with the REQUEST/NOREPLY command. REQUESTS are made with the 
REQUEST/REPLY command. 

The items specified are added or deleted from the current settings. For example, 
/KEEP=MESSAGES adds messages to the keep list but does not change the 
REQUESTS setting. Specifying /KEEP without an argument is equivalent to 
/KEEP=ALL. Specifying /NOKEEP is equivalent to /KEEP=NONE. 
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17.2.3 SET TERMINAL/OPERATOR_SERVICES Command 


This command changes the settings of an operator terminal. Use this command to 
specify whether operator messages or requests or both are broadcast to a specific 
terminal. SET TERMINAL/OPERATORJ3ERVICES requires OPER privilege. 

See Chapter 8 for a complete description of the SET TERMINAL command. 


Format 

SET TERMINAL/OPERATOR_SERVICES [de v[:]] 

Command Qualifiers Default 

/[NO]OPERATOR_SERVICES[=(keyword[,...])] /OPERATOR_SERVICES=ALL 


Command Parameters 

[dev[:]] 

Specifies the terminal to be modified. If you do not specify a device, the charac¬ 
teristics of the terminal issuing the command are changed. 

Command Qualifiers 

/[NO]OPERATOR_SERVICES[=(keyword[,...])] 

Specifies what items, if any, are broadcast to the terminal. Valid keywords are 
ALL, [NOJMESSAGES, [NOJREQUESTS, and NONE. MESSAGES are requests 
made with the REQUEST/NOREPLY command. REQUESTS are made with the 
REQUEST/REPLY command. 

The items specified are added or deleted from the current settings. For exam¬ 
ple, /OPERATOR_SERVICES=MESSAGES adds messages to the terminal’s 
characteristics but does not change the REQUESTS setting. 

Specifying /OPERATOR_SERVICES without an argument is equivalent to 
/OPERATOR_SERVICES=ALL. Specifying /NOOPERATOR_SERVICES is equiva¬ 
lent to /OPERATOR_SERVICES=NONE. 
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17.2.4 SHOW OPERATOR SERVICES Command 


This command displays the status of the OMS package. The display includes the 
following information: 

• The current version of the Operator/Message Services package 

• The date and time the OMS package was last started 

• The date and time the OMS package was last modified 

• Whether messages or requests or both are stored in the OMS log file 

• Whether messages or requests or both are broadcast to any operator terminals 


Format 

SHOW OPERATORSERVICES 

Command Qualifiers Defaults 

/[NO]OUTPUT[=file-spec] Your terminal 


Command Qualifiers 

/[ NO]OUTPUT=file-spec 

Controls where the output of the command is sent. If the qualifier is not specified 
or if /OUTPUT is entered without a file specification, the output is sent to the 
user’s terminal. 

If /NOOUTPUT is specified, output is suppressed. 
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17.2.5 SHOW REQUESTS Command 


This command formats and displays requests stored in the OMS work file. You 
can select messages or requests for display based on a number of selection criteria 
using command the qualifiers SHOW REQUESTS requires OPER privilege. 


Format 


SHOW REQUESTS 

[request-id] 

Command Qualifiers 

Defaults 

/ALL 

/ALL 

/BEFORE=date-time 

See discussion 

/BRIEF 

/BRIEF 

/[NO] EXACT 

/NOEXACT 

/FA C1L IT Y=(f aci lity-l ist) 

none 

/FULL 

/BRIEF 

/INPUT=file-spec 

See discussion 

/JOB=job-number 

none 

/[NO]OUTPUT[=file-spec] 

your terminal 

/[NOJREPLY 

/ALL 

/SINCE=date-time 

See discussion 

/TERMINAL=dev[:] 

none 

/TEXT=["]string["] 

none 

/USER=[p,pn] 

/USER=[V] 


Command Parameters 

request-id 

Displays messages or requests or both with the specified ID number. 

The ID number is a 4-digit number assigned to the message or request at the 
time it was entered in the OMS log file. The ID number is not guaranteed to be 
unique. It is possible to have more than one message or request with the same 
ID number. For example, ID number 1 will be assigned after ID number 9999. 
This may cause multiple messages with ID number 1 in the log file. 

Command Qualifiers 

/ALL 

Displays both messages and requests. This qualifier conflicts with the 
/[NOJREPLY qualifier. If both qualifiers are specified in the same command, 
only the rightmost qualifier is used. If neither qualifier is specified, the default is 
/ALL . 

/BEFORE=date-time 

Displays messages or requests or both made before the specified date and time. 
Either an absolute or relative date and time can be specified. If no date is 
specified, TODAY is assumed. If no time is specified, 12:00AM is used. 
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If this qualifier is not specified, messages or requests are not selected based on an 
ending date and time. 

/BRIEF 

Indicates that replies to requests are not displayed. This qualifier conflicts with 
/FULL. If both qualifiers are specified on the same command, the rightmost 
qualifier is used. If neither /BRIEF nor /FULL is specified, the default is /BRIEF. 

/[NO]EXACT 

Indicates how the text specified by the /TEXT qualifier is matched against the 
text of a request. This qualifier must be used with the /TEXT qualifier. 

Specifying /NOEXACT indicates the uppercase and lowercase characters are 
treated as equivalents. The default is /NOEXACT. 

Specifying /EXACT indicates that the text of the search string must match exactly 
with the text in the request. This causes the system to use less CPU time when 
scanning requests. Therefore, it is more efficient to use /EXACT when the case of 
the search text is known. 

/FACILITY=(facility-list) 

Displays messages or requests or both from the specified facilities. Up to eight 
facilities can be specified. Parentheses are not required if only one facility is 
specified. 

The NO prefix can be used to display messages or requests or both from facilities 
other than those specified. For example, /FACILITY=(LOGIN,LOGOUT) displays 
only messages from the LOGIN and LOGOUT programs. 
/FACILITY==(NOPBS,NOOMS) displays all messages or requests or both from 
facilities other than PBS and OMS. If you use the NO prefix with one facility 
name, you must specify it on all the facility names in the list. Failure to do so 
results in a "?Conflicting elements" error. 

If the /FACILITY qualifier is not used, messages or requests are not selected 
based on facility name. 

/FULL 

Indicates that replies to requests are displayed. This qualifier conflicts with 
/BRIEF. If both qualifiers are specified on the same command, the rightmost 
qualifier is used. This qualifier is ignored if used with /NOREPLY. If neither 
/FULL nor /BRIEF is specified, the default is /BRIEF. 

/INPUT=file-spec 

Selects an alternate input file (or files) to be examined. Can be used to display 
requests from a previous OMS log file. Wildcards are allowed for the file name 
and extension fields. You must have read access to the file(s) specified. 

If this qualifier is not specified, requests are displayed from the current OMS log 
file, OMS$: RE QLOG. OMS. 

/JOB=job-number 

Displays messages or requests or both made by the specified job number. 

If this qualifier is not specified, messages or requests are not selected based on 
job number. 

/[NO]OUTPUT[=file-spec] 

Controls where the output of the command is sent. If the qualifier is not specified 
or if /OUTPUT is entered without a file specification, the output is sent to the 
user’s terminal. If /NOOUTPUT is specified, output is suppressed. 
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/[NO]REPLY 

Selects whether messages or requests are displayed. The /NOREPLY quali¬ 
fier is used to display messages, for example, those requests made with the 
REQUEST/NOREPLY command. The /REPLY qualifier is used to display 
requests made with the REQUEST/REPLY command. 

This qualifier conflicts with the /ALL qualifier. If both qualifiers are specified 
on the same command, the rightmost qualifier is used. If neither qualifier is 
specified, the default is /ALL. 

/SINCE=date-time 

Displays messages or requests or both made since the specified date and time. 
Either an absolute or relative date and time can be specified. If no date is 
specified, TODAY is assumed. If no time is specified, 11:59PM is used. 

If this qualifier is not specified, messages or requests are not selected based on a 
starting date and time. 

/TERMINAL=dev[:] 

Displays messages or requests or both made from the specified terminal. The 
keyword DETACHED can be used in place of the device name to display messages 
or requests or both made by detached jobs. 

If this qualifier is not specified, messages or requests are not selected based on 
the terminal from where they were made. 

/TEXT=[ M ]string["] 

Displays messages or requests or both containing the specified string. Enclose 
strings containing lowercase letters or nonalphanumeric characters (including 
spaces) in quotation marks. Include the /[NOjEXACT qualifier to specify the 
method that the text string is matched against the text of a message or request. 

If this qualifier is not specified, messages or requests are not selected based upon 
their text. 

/USER=[p,pn] 

Displays messages or requests or both made by the specified user. The pro¬ 
ject/programmer number must be specified in the format [p,pn], where p is the 
project number and pn is the programmer number. The wildcard character (*) 
can be used to specify all users within a project or programmer group. 

If this qualifier is not specified, messages or requests are not selected based on 
project/programmer numbers. 
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17.2.6 START/OPERATOR SERVICES Command 


This command starts the OMS package. START/OPERATORJSERVICES requires 
SWCTL and OPER privileges. 


Format 


START/OPERATOR SERVICES 


Command Qualifiers 
/[N O] KE E P[=(keyword[,...])] 
/PRIORITY=n 
/RUN BURST=n 


Defaults 
/KEEP=ALL 
/PRIORITY=-8 
/RUN BURST=6 


Command Qualifiers 

/[NO]KEEPt=(keyword [,...])] 

Specifies what items, if any, are stored in the OMS log file. Valid keywords are 
ALL, [NO]MESSAGES, [NOJREQUESTS, and NONE. MESSAGES are requests 
made with the REQUEST/NOREPLY command. REQUESTS are made with the 
REQUEST/REPLY command. 

The items specified are added or deleted from the current settings. For example, 
/KEEP=MESSAGES adds messages to the keep list but does not change the 
REQUESTS setting. Specifying /KEEP without an argument is equivalent to 
/KEEP=ALL. Specifying /NOKEEP is equivalent to /KEEP=NONE. 

/PRIORITY=n 

Specifies the priority of the detached OMS job. Value must be in the range -120 
to +120. Any specified value is rounded down to a multiple of 8. The default is -8. 

/RUN_BURST=n 

Specifies the run burst of the detached OMS job. Value must be in the range 1 to 
127. The default is 6. 
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17.2.7 STOP/OPERATOR SERVICES Command 


This command shuts down OMS, either immediately (causing all pending 
requests to be aborted) or when all pending requests have been answered. 
STOP/OPERATORJ3ERVICES requires SWCTL and OPER privileges. 

The OMS package can be shut down in the following ways: 

• As part of normal system shutdown. The SHUTUP program includes a phase 
for automatically shutting down OMS. 

• Manually, using the STOP/OPERATOR_SERVICES command. 


Format 

STOP/OPERATOR_SERVICES 

Command Qualifiers Default 

/[NO] ABORT /NOABORT 


Command Qualifiers 

/[ NOJABORT 

Specifies whether pending requests are aborted before the Operator/Message 
Services package shuts down. If /ABORT is specified, OMS performs a 
REPLY/ABORT command for each request that is currently pending. 

If /NOABORT is specified, OMS performs a REPLY/PENDING command for each 
request that is currently pending. The text of the reply message indicates that 
the OMS package is being shut down. OMS shuts itself down when all pending 
requests have been answered. The default is /NOABORT. OMS will not accept 
any new requests while processing a STOP command. 
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Appendix A 

Managing the OPSER Spooling Package 


This appendix describes the OPSER-based spooling package. This package, like 
the new Print/Batch Services (PBS) package (see Chapter 9), provides print and 
batch services. Most of the programs require SWCFG privilege to run. General 
aspects of related user programs, such as QUE and BATCH, are mentioned only 
briefly in this appendix. See the RSTS/E Utilities Reference Manual for a full 
description. 

The information presented here is for backwards compatibility only. New 
applications should use the PBS package. Move existing applications to PBS over 
time. PBS is: 

• More efficient 

• More flexible 

• Easier to manage 

• Handles DCL command files 

• Permits 8-bit and control characters on printers 

• Has job limits 


A.1 Overview of Operator Services 

Operator services on RSTS/E involve the OPSER program and controlled 
programs in OPSER tables. Controlled (online) programs are: 

• QUEMAN 

• SPOOL 

• BATCH 

• RESTOR 

SPOOL and BATCH are spooling programs executing queued requests for either 
a line printer device or batch processor. QUEMAN is the queue manager program 
that passes queued requests to spooling programs and adds, updates, and deletes 
requests in the various queues. RESTOR is the optional system data restoring 
package that OPSER can control. 
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A.1.1 OPSER Program Overview 

The OPSER program establishes inteijob communication for all of its controlled 
programs. OPSER declares itself a message receiver with a systemwide identi¬ 
fication that the controlled programs can recognize. When a controlled program 
starts, it declares itself a message receiver and supplies OPSER with certain 
data by means of the system message send/receive SYS call. OPSER places the 
program in its table of online jobs. See the RSTS/E Programming Manual for 
information about SYS calls. 

The identification that OPSER uses to communicate with online programs is 
called the message receiver identification, or simply, the receiver identification. 
Each identification exists in the system message receiver table and must be 
unique. Because of this uniqueness, only one copy of OPSER can be running 
on your system. Additionally, because all control and interjob communication of 
spooling jobs depends on OPSER, the operator services program must be running 
before any controlled jobs can be run. 

After it establishes initial interjob communication, OPSER makes it possible 
for an operator to interact with the controlled jobs. OPSER becomes the main 
interface between the operator and a system controlled program. Figure A—1 
shows the interaction among system controlled programs and the operator. 
OPSER broadcasts information to the operator through a terminal designated as 
the Operator Services Console (OSC). For flexibility, the operator can make any 
keyboard line on the system the the OSC. To isolate the keyboard control from 
unwarranted tampering, OPSER itself does not need to be connected to the OSC, 
but may broadcast data on the physical keyboard line. Given that intermittent 
output is generated on the OSC, any other user (including the operator) could be 
logged into the system on that terminal. 

OPSER itself establishes a data base by which it controls online jobs. The data 
base resides in the OPSER package account OPSER$: and consists of three work 
files: 

• OPSERO.WRK—Contains the current activities and message control directory 
tables 

• OPSER1.WRK—Has the table of jobs on line to OPSER, the valid operator 
table, and tables of messages and legal commands 

• OPSER.LOG (which can be optionally renamed)—Provides a history of 
operating activity 

To provide a nonvolatile data base during a timesharing session, as well as con¬ 
tinuity of operations between timesharing sessions, OPSER stores the work file 
information on disk. Thus, if the system crashes or if OPSER alone unexpect¬ 
edly terminates, the work files retain the most current processing information. 
Similarly, these files maintain data continuity from one timesharing session to 
another. 

Whenever OPSER starts, it examines its files to determine whether entries in 
the online job and valid operator tables are still valid. Generally, OPSER retains 
active and valid entries and purges any entries that do not satisfy validation 
requirements. Upon restarting, therefore, OPSER attempts to preserve data from 
its previous operational state. 
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The most convenient way to interact with OPSER is through the PLEASE 
program. PLEASE transmits commands to the OPSER program. OPSER checks 
that the sender is a valid operator and, if so, takes the requested action. Because 
of PLEASE, the operator need never directly run or attach to OPSER to perform 
operator functions on controlled jobs. See the section "Operator Communication 
Program: PLEASE" for a description of the PLEASE program. 

Figure A-1: System Controlled Programs and Operator Interaction 


OPSERS:QUEUE.WRK OPSERS.TEMPnn.QUE 
File File 



Communication method: 

- 7* broadcast 

-message send/receive 

-- direct access 


OPSER$:OPSERO.WRK OPSER$:OPSER.LOG 

File File 

OPSERS:OPSER1.WRK 
File 

l-MK-00077-01 


OPSER provides processing checks for online jobs. OPSER makes sure that all 
online jobs are still active, are still valid receivers, and are not hibernating. If 
any job is found to be hibernating, OPSER notifies the operator, who can attach 
the job to a terminal, remedy the cause of the hibernation, and/or restart the job 
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OPSER interaction between a controlled job and the operator is recorded in one 
of three ways: 

• As a message—A message is specifically formatted data to which OPSER 
assigns a sequence number for operator reference. 

• As an action request—An action request is a special message that requires 
operator action and a response before a controlled job can resume processing. 
A request usually involves both performing an action (such as mounting 

a volume) and typing an answer (such as a device designator or program 
interrupt command) in direct response to the request. 

• As an information line—An information line is a free form report of some 
internal operation performed. Information lines are typically not important to 
the operator function but merely provide a history of online events. 


A.1.2 QUEMAN Program Overview 

The QUEMAN program manages the system queue file OPSER$:QUEUE.SYS. 
The file retains all pending user requests and can store requests between 
timesharing sessions. Users make requests of spooling programs through the 
QUE system program. To form a request for a user, QUE builds a message and 
sends it to QUEMAN, which updates the QUEUE.SYS file. 

QUEMAN maintains a table of online spooling programs in a work file, 
QUEUE.WRK, which is stored in the OPSER package library (OPSER$:). 

The program passes a queued request to a destination spooling job not currently 
busy with a request. As a spooling job completes a request, it notifies QUEMAN, 
which updates the queue and work files and checks for another request to pass to 
the spooling job. 

A spooling program typically handles one request at a time from QUEMAN. If 
no request is pending for a spooling program, the job enters an indefinite sleep 
state. The job is not awakened until the system queues a message for it. The 
message is the result of QUEMAN or OPSER transmitting data to the spooling 
job by means of the system message send/receive mechanism. 

To retain as much data as possible between timesharing sessions, QUEMAN, 
like OPSER, examines its files upon restarting. After restarting, QUEMAN 
should resume processing with no loss of data from its previous run. QUEMAN 
examines the queue file structure and contents and reestablishes synchronization 
with any spooling jobs already on line and active. 


A.1.3 SPOOL Program Overview 

The SPOOL program handles requests made for line printer output. SPOOL 
maintains dual communication paths: one with QUEMAN and one with 
OPSER. QUEMAN transmits queued requests to SPOOL. SPOOL interacts 
with QUEMAN only to notify it that a transmitted request is completed. Under 
normal circumstances, communication between SPOOL and OPSER is necessary 
only when an operator requires some special action (for example, aligning forms) 
of the spooling job. 

To identify output of a user’s queued request, SPOOL prints heading burst pages. 
The program accesses the character generation file OPSER$:CHARS.QUE to form 
the large, easily readable letters necessary to distinguish discrete requests and 
files within a request. 
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A.1.4 BATCH Program Overview 

The BATCH program executes user requests by running a job for a user on a 
static pseudo keyboard defined with the SET SYSTEM command. By using a 
pseudo keyboard, BATCH eliminates the requirement for a physical terminal and 
relieves the user from typing by processing commands from a disk file. 

BATCH, like SPOOL, maintains dual communication paths: one with QUEMAN 
and one with OPSER. QUEMAN sends a message to BATCH to process a job 
request. BATCH interacts with QUEMAN only to notify it that a transmitted 
request is completed. BATCH typically depends on OPSER to form requests for 
operator action. To mount a user volume, for example, BATCH notifies OPSER. 
In turn, OPSER generates the request for the operator and processes the response 
from the operator. 

To process commands from a user-queued disk file, BATCH requires the command 
decoding file OPSER$:BATCH.DCD. The BATCH.DCD file contains all the codes 
and parameters BATCH needs to decode user-specified control statements, 
perform syntax checking, and form a special intermediate file (BAnJmm.COM) of 
encoded BATCH commands. 

Both the SPOOL and BATCH programs charge processing (execution) time to the 
account under which the user queues the request. Overhead time, used to set up 
a request, is charged to the account under which the program is running. 


A.1.5 RJ2780 Program Overview 

The RJ2780 program is an optional layered product, available through DECUS 
Unlike BATCH and SPOOL, RJ2780 maintains only one communication path. 
QUEMAN sends a message to RJ2780 to process the next request (send a file). 
The RJ2780 program can also send a message to QUEMAN requesting that 
SPOOL print a file that RJ2780 has received. RJ2780 has no communication 
with OPSER. 


A.1.6 Controlling RESTOR with OPSER 

An operator can control the RESTOR program through OPSER. If RESTOR runs 
detached, control through OPSER is the only means by which the operator can 
communicate with the RESTOR job. RESTOR, when detached, transmits all 
operator requests through OPSER and receives responses only from OPSER. 


A.1.7 Overview of OPSER Shutdown 

The entire operator services package is designed to terminate in a controlled 
manner using a "shutdown level." The defined shutdown level for each job 
determines the order in which OPSER terminates controlled jobs during system 
shutdown. The SHUTUP system program can be run so OPSER terminates 
controlled jobs with the lowest shutdown level first. OPSER informs each job at 
a certain level to complete processing at a logical end point. Only after OPSER 
shuts down all jobs at a given level does it proceed to shut down all jobs at the 
next highest level. SHUTUP itself does not proceed with final system shutdown 
until OPSER terminates all of its controlled jobs and kills itself. By using the 
controlled shutdown of OPSER, you can ensure continuity of processing user 
requests from one timesharing session to another. 
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Since RJ2780 does not communicate with OPSER, OPSER does not automatically 
shutdown RJ2780 as it does SPOOL and BATCH. 


A.2 Operator Services Program: OPSER 

The operator services program OPSER consists of two modules: 

• OPSER —Establishes the initial conditions on startup, checks initial 
conditions upon restart, and chains to the second module, OPRUN 

• OPRUN—Executes commands and periodically checks status. 

Each module is stored in the OPSER Package Library (OPSER$:), has a 
protection code of <232>, and requires SWCFG privilege to run. For simplicity, 
this appendix refers only to one program, OPSER, which functionally includes the 
two modules. 

You must run the OPSER program before the queue manager and spooling 
programs. If your applications need to use the OPSER package, you should start 
OPSER by including the RUN command in your system startup command file. To 
start OPSER, type the following command: 

$ RUN OPSER$:OPSER 

OPSER V10.0 RSTS V10.0 TIMESHARING 

• 

At this point, the OPSER program performs a number of checks before it prints 
the number sign (#) prompt. The remaining portion of this section describes these 
initial program checks. Once you are familiar with this procedure, you can learn 
about OPSER operator commands, described in the following sections. 

If the you have SWCFG privilege, the program prints an identification line at the 
terminal to indicate it is running. If you do not have SWCFG privilege, OPSER 
displays an error message to indicate that you do not have access to OPSER. 

OPSER tests for the presence of its two work files (OPSERO.WRK and 
OPSER1.WRK) in OPSER$:. If the work files are not present, OPSER prints the 
warning message: 

%OPSER files not found - will initialize ... 

OPSER then initializes all its tables. At this point, the valid operator table has 
a single entry that allows the current user (on any terminal) to communicate 
through OPSER. If ERRCPY is active, the online job table has ERRCPY as its 
only entry. 

When OPSER finds the work files, it makes sure that it has write access to 
the files. Should another job have write access to the files, OPSER prints the 
following warning message and terminates: 

%OPSER does not have write privileges to its files 

To allow OPSER to gain write access, the operator must terminate the job 
currently having write access and run OPSER again. 

The program performs further special processing for currently existing work files. 
The processing makes sure of data integrity in case OPSER is being restarted 
after a system crash. A check is made of the entries in the online job and valid 
operator tables. 
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For each entry in the online job table, OPSER checks the following conditions: 

• The job number indicated in the entry must be active on the system. 

• The receiver identification in the entry must exist in the system message 
receiver table for that job number. 

• The account in the entry must be a valid account number. 

An entry for an inactive or otherwise illegitimate job is removed from the online 
job table. For each active and legitimate job, OPSER requests retransmission of 
the job’s last message when processing begins. When processing begins, OPSER 
generates a command to display the online job table. 

OPSER checks the entries in the valid operator table. Additional actions take 
place depending on whether jobs found in the online job table are active. If 
the online job table has no active jobs and a meaningless entry is in the valid 
operator table, OPSER clears the table and sets initial conditions. The resulting 
operator table has one entry that allows, as valid operators, the current user 
from any keyboard. If the online job table has an active job, the program merely 
removes those entries that have no meaning from the valid operator table. To 
signal a change in the current table, OPSER creates an internal command to 
print the valid operator list when processing begins. 

After processing of the work files is complete, the program attempts to declare 
OPSER as a receiving job. If the declaration fails, the program prints the error 
message: 

?OPSER cannot declare itself a receiver 

This message indicates that another copy of OPSER has been run and must be 
properly terminated to allow the current copy to run successfully. 

OPSER establishes the current keyboard as the Operator Services Console (OSC) 
and a file named OPSER.LOG as the default log file. OPSER.LOG is optional, 
but OPSER uses it until an explicit command closes it or assigns another log 
file. When OPSER begins normal operation, it executes any internally generated 
commands to list online jobs and valid operators. After executing the commands, 
OPSER is ready to accept data sent to it by any program. OPSER prints the 
number sign (#) character to show that it is ready to accept commands. 


A.2.1 OPSER Operator Commands 

You can abbreviate a valid OPSER command to three or more characters and 
separate the command from any operands by a space character. No embedded 
spaces are allowed within a command. Delimiters within the text of the operands 
are the semicolon (;) and colon (:) characters and must be present to delimit 
elements of text. Throughout the following discussion, note that square brackets 
enclose optional items. 
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Table A-l summarizes the commands and formats. Note that the circumflex ( A ) 
character marks the location of a required space. 


Table A-1: OPSER Commands 


Command Name 

Syntax and Meaning 

ANSWER 

AN S[WER] A msgnumber:text 

Conveys the text following the colon as a response to an 
action request denoted by message number. Also deletes the 
action request. 

CHANGECONSOLE 

CHA[NGECONSOLE] A KBn: 

Changes the operator services console to the keyboard unit 
designated by n. The unit should be on line but need not be 
free. It must also be set for /BROADCAST (see Chapter 8). 

DELETE 

DEL[ETE] A msgnumber 

Deletes from an OPSER internal table an unanswered action 
request denoted by its message number. DEL[ETE] A #m[:n] 
Deletes the n oldest (from 1 to 32) action requests for a given 
job. The command requires the number sign (#), the number 
(m) of the sending job, a colon (:), and the number (n) of 
requests to delete. 

DETACH 

DET[ACH] 

Detaches the OPSER program from its keyboard, after which 
the operator can run PLEASE to communicate with OPSER. 

EXIT 

EXI[T] 

Closes the log file and work files, removes OPSER from 
the system message receiver table, and terminates the 
program. If the job is attached, the program returns you 
to the keyboard monitor prompt. If detached, the program 
broadcasts a message to the system console terminal (KBO:) 
and kills itself. 

FORM.FEED 

Enables the printing of two form feeds at the beginning of 
each print job. 

FORMSJWAIT 

INTERRUPT 

Enables the ’’Forms waiting” message. 

INT[ERRUPT] A rcvrid:text 

INT[ERRUPT] A #n:text 

Sends the unsolicited text to an online job specified either 
by its message receiver identification or by #n (where n 
is the number of the job under which the online program 
is running). The LIST JOBS command listing gives job 
numbers and receiver identifications. 

LIST 

LIS[T] A JO[BS] 

LIS[T] A OP[ERATORS] 

Prints a listing of all jobs on line to OPSER or a listing of 
valid operator accounts and keyboards. 


(continued on next page) 
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Table A-1 (Cont.): 

OPSER Commands 

Command Name 

Syntax and Meaning 

LOGFILE 

LOG[FILE] A [file];[msglevel] 

Establishes, as the OPSER log file, the specified file or device 
and sets the message level to the value specified. If a file or 
device is not specified, a semicolon followed by a level simply 
changes the message level of the open log file. If neither a 
file nor message level is specified, OPSER closes the current 
log file and records nothing more. 

LOG[FILE] A [file];AL[L] 

ALL records all messages and action requests. 
LOG[FILE] A [file];RE[QUESTS] 

REQUESTS records only action requests. 
LOG[FILE] A [file];NO[NE] 

NONE records no messages, action requests, or OPSER 
information lines. 

MESSAGE 

ME S[SAGE] A [level] 

Sets the level of messages for the OSC. The level con¬ 
trols what types of messages are printed at the OSC. If 
no level is included in the command, an error is gener¬ 
ated. MES[SAGE] A AL[L] ALL includes all messages, action 
requests, and OPSER information lines. 

MES[SAGE] A RE[QUESTS] 

REQUESTS includes only action requests and information 
lines and excludes messages. 

MES[SAGE] A NO[NE] 

NONE means that nothing is printed on the OSC. (See the 
section "Message Types" for a discussion of message level.) 

NOFORM.FEED 

Disables the printing of two form feeds at the beginning of 
each print job. 

NOFORMS_WAIT 

OPERATOR 

Disables the "No forms waiting" message. 
OPE[RATOR] A KBn:[p,pn] 

Updates the valid operator list with the designated keyboard 
unit and account combination. The asterisk (*) character 
can replace the keyboard unit, project number(p), and 
programmer number (pn) to include all of that element. 
OPE[RATOR] A -KBn:[p,pn] 

If a minus (-) sign precedes the specification, that specific 
element is deleted from the list. 

RETYPE 

RETfYPE] A m sgnumber 

Reprints, at the requesting terminal, an unanswered action 
request denoted by its associated message number. 

RET[YPE] A [#n[:n]] 

Several unanswered action requests can be printed by giving 
the number of the sending job. If :n is given with the job 
number, the n oldest (from 1 to 32) action requests are 
printed for that job. 


NOTE 


Entering an account that does not have SWCFG privilege in the 
OPSER operator table with the OPERATOR command allows anyone 
logged in to that account access to all accounts. You must use caution 
when deciding which accounts you place in the OPSER operator table. 
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A.2.2 Message Types 

OPSER displays two types of information on the Operator Services Console 
(OSC): messages and action requests. Messages are simply informative. For 
example, a message might tell you that a control file has been queued for batch 
processing. Action requests require an operator to perform some action before the 
job continues (for example, mounting a tape). 

The MESSAGE command lets you define the level of information displayed at the 
OSC. For example: 

• MESSAGE ALL—You want both messages and action requests displayed at 
the OSC. 

• MESSAGE REQUESTS—You want only action requests displayed at the 
OSC. Messages are held in a table until you specify MESSAGE ALL. 

• MESSAGE NONE—You do not want any messages displayed at the OSC. 
Messages and requests are held in a table until you specify MESSAGE ALL 
or MESSAGE REQUESTS and then the RETYPE command. 

When OPSER starts, the default is MESSAGE ALL. If you suspend the display 
of messages, or messages and requests, by typing MESSAGE REQUESTS or 
MESSAGE NONE, the suspended items are held in a table. The table can hold a 
maximum of 32 messages or requests. (The actual number held depends on the 
length of the messages and requests.) If OPSER receives a message or request 
after the table is full, the new message or request is added to the table, and the 
oldest message or request is deleted. 

Thus, you should not suspend message printing for long, or you may lose 
messages and requests. When you want to see messages and requests again, type 
MESSAGE ALL. Then use RETYPE to print the messages and requests currently 
held in the table. 

If you see ’’Message Table Full" displayed at the OSC, it means that a message 
was received, and the table was full. Some unknown number of old messages and 
requests had been lost while MESSAGE NONE or MESSAGE REQUESTS were 
in effect. 

To help you distinguish between messages and action requests on the OSC, 
output appears in distinct formats. A single TAB character denotes message text; 
two TAB characters denote action request text. 

Message requests have the format: 

MESSAGE nnnnn : date time JOB:NN KB:MM jobname [p,pn] 

text 

If the first character of the message text is a question mark (?) character, the 
words FATAL MESSAGE replace MESSAGE in the identification line. 

Action requests have the format: 

REQUEST nnnnn : date time JOB:NN jobname [p,pn] rcvrid 

text 
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In an action request, the first character of text is a Ctrl/G (BEL) that sounds a 
bell in the terminal to alert the operator. Table A-2 summarizes the contents of 
messages and action requests. 


Table A-2: OPSER Message and Action Request Contents 


Item 

Meaning 

nnnnn 

Sequence number of message starting at 1 and incremented by 1 
during processing; use with the ANSWER command to respond to a 
specific action request. After restarting with currently existing work 
files, OPSER rounds the last assigned sequence number up to the next 
multiple of 10. This number is the next assigned sequence number. 

date 

Current system date. 

time 

Current system time of day. 

JOB:nn 

Job number under which sending program is running; use it, preceded 
by the number (#) sign, to refer to the job in an INTERRUPT, DELETE, 
or RETYPE command. 

KB:mm 

The keyboard number of the job that sent the message. The KB:mm 
field is displayed as DET if the job was detached, and as KB:?? if 
OPSER is unable to determine the keyboard number. Typically, the 
KB:?? message appears when the job has terminated. 

jobname 

Name of the program that an online sending job is running; this name 
is printed for information purposes. OPSER prints six question marks, 
??????, in place of the jobname if it is unable to determine the jobname. 
Typically, the ?????? message appears when the job has terminated. 

[p,pn] 

Project-programmer number (PPN) under which the sending online job 
is running. 

rcvrid 

For action requests only. The message receiver identification given to 
the job when it is started. The identification can be standard (LPnSPL 
for the SPOOL program or BAnSPL for the BATCH program) or can 
be optional (as specified in the NAME startup switch for SPOOL 
or BATCH). Use the receiver identification with the INTERRUPT 
command to refer to the spooling program. 


An action request is the result of a spooling job’s requesting interaction with the 
operator: the spooling job sends a message to OPSER. The spooling job performs 
no further processing until operator action is taken or until the condition that 
generated the action request is satisfied. OPSER broadcasts action requests on 
the OSC unless the message level is set to NONE. 

Tb respond to an action request, the operator uses the ANSWER command. 
Because OPSER usually runs detached, an operator can run PLEASE at valid 
operator terminals to send the response to OPSER. The ANSWER command 
requires a message number to identify the action request to which the operator is 
responding. 

OPSER sends the text in the ANSWER command to the spooling program and 
deletes the action request. If the response satisfies the request, the program 
resumes processing. If the response does not satisfy the request, the spooling 
program still expects an appropriate response. The operator must then send such 
a response by means of the INTERRUPT command (see the section "Operator 
INTERRUPT Command"). 
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A.2.3 Valid Operator and Online Job Lists 


The LIST command displays data concerning the valid operator list or the online 
job table maintained by OPSER: 

• LIST OPERATORS displays the keyboard number and PPN combinations 
currently defined as valid operators. The OPERATOR command updates the 
valid operator list. Initially, only users with SWCFG privilege can update the 
valid operator list. 

• LIST JOBS prints the header ONLINE JOB and then prints data concerning 
online jobs in the following format: 

#n [p,pn] ’rcvrid’ SL=n 

Table A-3 describes the items in the online job list. 

Table A-3: OPSER Online Job List 


Item Meaning 

#n The job number under which the online program is running. 

[p,pn] The PPN under which the online job is running. 

’rcvod’ The message receiver logical identification used to identify the online 

program in INTERRUPT commands. 

SL=n The OPSER shutdown level used when SHUTUP notifies OPSER to 

terminate spooling operations in an orderly fashion. 


The job data listed is important to the operator. For example, certain OPSER 
commands require either a receiver identification or job number to communicate 
with a spooling program. 


A.2.4 Operator INTERRUPT Command 

The INTERRUPT command sends unsolicited messages and special commands 
to spooling programs. OPSER accepts any text in the INTERRUPT command 
and sends it to the destination job. Only the destination job interprets the text. 

If a response to an INTERRUPT command is generated, it is displayed on the 
OSC. Tables A-6, A-12, and A-15 summarize special text interpreted by spooling 
programs as commands. 

The INTERRUPT command allows an operator to control and to monitor spooling 
programs. Each spooling program recognizes commands that can be divided into 
three sets: 

• Commands that have no direct effect on how the program itself processes 
a request queued by a user. Included in this set of commands are PAUSE, 
CONTINUE, NOTICE, LAST, and STATUS. They allow the operator to 
control the program in general and to gain information about the program. 

• Commands that do have a direct effect on program operation but are uniform 
for all spooling programs. END, ABORT, and OFFLINE represent this type of 
command which directly influences the job. 

• Commands that are unique to the individual spooling program. A command 
for forms control on a line printer is an example. 
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A.2.5 OPSER Startup Procedure 

Use commands in the system startup control file to start the OPSER program. 
See "System Startup Command File: START.COM" in Chapter 3 for information 
about creating a startup control file. This section describes the commands you 
should include in that startup file. 

The following is a typical sequence of startup file commands to start OPSER: 

$ RUN OPSER$:OPSER 

LOG OPSER$rOPSER.LOG;ALL 

CHA KBO: 

MESS ALL 
OPER KB*:[1,2] 

DETACH 

The LOGFILE, CHANGECONSOLE, MESSAGE, OPERATOR, and DETACH 
commands establish initial operating conditions for OPSER. The LOGFILE and 
MESSAGE commands set conditions normally established as defaults and are 
shown for clarity. An explanation of these commands follows: 

• The LOGFILE command retains the file OPSER$:OPSER.LOG with a 
message level of ALL. As a result, all messages, action requests, OPSER 
information lines, and operator responses are written to the file to provide a 
complete historical reference. 

• The terminal on which OPSER starts is automatically defined as the OSC. 
You can change this definition by placing the CHANGECONSOLE command 
in the startup procedure. Any valid operator may also alter the assignment of 
the OSC. It is most convenient to keep keyboard unit 0 as the OSC because, 
regardless of the number of logins currently allowed on the system, the 
operator can always use the system console terminal to communicate with 
OPSER. 

• The MESSAGE command specifies that all messages, action requests, and 
OPSER information lines are printed at the OSC. Normally, the operator 
is concerned only with action requests. If the operator is concerned with 
any unanswered action request, the RETYPE command can be issued. In 
addition, the log file can be closed with the LOG command and printed at any 
time to recover recorded information. 

• The OPERATOR command updates the valid operator list with user [1,2] on 
any keyboard. Allowing the operator to communicate from any terminal on 
the system gives flexibility to those who are performing operator functions. 

• The DETACH command causes OPSER to detach itself from the terminal on 
which it is running. At the start of timesharing, this terminal is usually the 
system console terminal (KBO:). While OPSER runs detached, it is immune 
from tampering by unauthorized users. The operator can communicate with 
OPSER through the PLEASE program. 


A.2.6 OPSER Action Under Various Startup Conditions 

OPSER startup actions depend on the way OPSER last terminated: 

• When OPSER runs after you have shut down operator services in an orderly 
fashion through SHUTUP, a normal startup procedure occurs. When shutting 
down in an orderly fashion, OPSER removes all entries from its online job 
table and closes all files properly. On restarting, OPSER finds all data valid. 
The online job table is empty, and entries in the valid operator table are legal 
and therefore retained. 
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• When OPSER starts after a system crash, it may find entries in its online job 
table. Because OPSER starts before other online jobs, none of the jobs in the 
table is active; therefore, the program clears the entries from the table. If any 
entries in the valid operator table are illegal, OPSER clears that table and 
sets one valid operator entry: the current user from any keyboard. 

• When OPSER starts after an unexpected termination, it may find entries in 
its online job table for jobs still active on the system. In this instance, the 
program sends a command to each active job having an entry in the online 
job table. The command requests the job to retransmit the last message it 
sent to OPSER. OPSER does not wait for a response. If any job in the online 
job table does not meet OPSER’s integrity checks, OPSER removes its entry 
from the table (takes the job off line) and generates an internal LIST JOBS 
command. OPSER also scans the entries in the valid operator table. If any 
entry is illegal, the program removes it. If OPSER removes any entry, it 
generates an internal LIST OPERATORS command. 


A.3 Queue Manager Program: QUEMAN 

The queue manager program QUEMAN maintains the file of queued requests 
(QUEUE.SYS in the OPSER$: account and communicates with spooling programs 
to execute queued requests. Queue management involves two modules stored in 
the OPSER Package Library: QUEMAN and QUMRUN. Both modules have a 
protection code of <232>, and require SWCFG privilege to run. 

QUEMAN: 

• Sets initial conditions on starting 

• Checks initial conditions after restarting 

• Chains to QUMRUN 

QUMRUN: 

• Executes commands 

• Manages the queues 

For simplicity, the documentation refers only to one program, QUEMAN, which 
functionally includes the two modules. 

The QUEMAN program runs only if the job has SWCFG privilege and the OPSER 
program is running (that is, only if the name OPSER is in the system table of 
message receivers). Starting QUEMAN is a prerequisite to starting the spooling 
programs, lb start QUEMAN, type the following command while logged into the 
system under an account SWCFG privilege: 

$ RUN OPSER$:QUEMAN 

QUEMAN V10.0 RSTS V10.0 TIMESHARING 
STARTED AT: 01:52 PM ON 03-MAR-90 

If you do not have SWCFG privilege, the system displays an error message to 
indicate that you do not have access to QUEMAN. 

If the job has enough privilege, the program prints its identification line and 
startup lines and begins preliminary error checking. 
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QUEMAN tests for the presence of OPSER which must be started before 
QUEMAN can rim. If OPSER is not running, QUEMAN prints an informational 
message and terminates: 

QUEMAN cannot run without 'OPSER' active 

QUEMAN opens the files QUEUE. WRK, OPSER1.WRK, and QUEUE.SYS in 
the OPSER$: account. If QUEUE .WRK does not exist, the program prints the 
following informational message and creates the file: 

'QUEUE.WRK' not found - will initialize 

If OPSER1.WRK does not exist, the program prints the following informational 
message and terminates: 

OPSERl.WRK not found - can't run 

To recover, the operator must start the OPSER program before starting 
QUEMAN. If QUEUE.SYS does not exist, the program creates and initializes it. 
QUEMAN signals this action by generating the informational message: 

No queue file found - will initialize 

If QUEUE.SYS exists, QUEMAN makes sure that it has write access to the file. 
If another program has write access to the QUEUE.SYS file, QUEMAN generates 
the following message: 

Queue file opened by another program 
Try again (Y/N) <N>? 

The operator must determine which job has the file QUEUE.SYS open and must 
terminate that job. If you type Y in response to the question, QUEMAN retries 
the open operation. Typing N terminates QUEMAN. 

When the OPEN operation successfully gains write access to QUEUE.SYS, 
QUEMAN declares itself a message receiver on the system. If QUEMAN is 
already declared by a different job, the program prints the message: 

QUEMAN cannot declare itself as a receiver ... can't run 

The operator must terminate the other job so it is removed from the message 
receiver table. 

To make sure that the previous QUEMAN job closed the currently existing 
QUEUE.SYS file properly, the program checks a flag value in the file. If the flag 
is not properly set, the program prints the following informational message: 

Queue file not closed properly - now checking data for consistency 

A later informational message signals that all integrity checks were successful: 

Queue file data checked for consistency 

If the flag is properly set, QUEMAN performs consistency checking but does 
not print any messages unless it finds problems. If any problems are found, 
QUEMAN generates the following informational messages: 

Queue file data inconsistent - will initialize 
Initialized 

The INITIALIZED message indicates that QUEMAN has set all entries in 
the QUEUE.SYS file to their initial conditions and has removed all queued 
requests from the queues. See the section "QUEMAN Consistency Checking" for 
a description of the queue file consistency checks QUEMAN performs. 

After completing all initial checks, QUEMAN prints the number sign (#) prompt 
indicating its readiness to accept a startup command or switch. 
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A.3.1 QUEMAN Startup Commands and Switches 

Table A-4 lists the startup commands that QUEMAN recognizes. 

Table A-4: QUEMAN Startup Commands 


Command Syntax and Meaning 

DETACH DET[ACH] 

Detaches QUEMAN from the terminal. You should run QUEMAN 
detached. 

INITIALIZE INITIALIZE] 

Sets all the entries in the QUEUE.SYS file to their initial conditions 
and sets initial conditions for the spooling queues. Any currently 
queued requests are lost. 


Before QUEMAN executes the INITIALIZE command, it checks its online spooler 
table. If the table has an entry for a spooling job, QUEMAN prints the following 
informational message: 

Spoolers on line - can't initialize 

# 

QUEMAN also recognizes startup switches. One or more switches may appear 
following a command or may appear alone on a line in response to the prompt. 

Table A-5 lists the startup switches that QUEMAN allows. 

Table A-5: QUEMAN Startup Switches 

Option Syntax and Meaning 

PRIORITY /PRI[ORITY]:nnn 

Sets the job priority to nnn, where nnn can be from -120 to +120. 
Without the switch, the program automatically sets the priority to 0. 
You must have TUNE privilege to specify this qualifier. 

RUNBURST /RUN[BURST] :nnn 

Sets the job run burst to nnn, where nnn can be from 1 to 127. Without 
the switch, the run burst value currently assigned is used. You must 
have TUNE privilege to specify this qualifier. 


If any data entered in response to the number sign prompt are not valid com¬ 
mands or options, QUEMAN prints the following informational message: 

Invalid response - text 

The text is the data entered. The program prints the # prompt again. 

To detach QUEMAN, the operator types the DET command in response to the 
prompt. For example: 

# DET 

Detaching... 

The program then prints the DETACHING message and detaches itself from the 
keyboard. Note that you should always run QUEMAN detached. 

While detached, the job receives commands from the operator through OPSER 
(see the following section). At no time should the operator enter Ctrl/C to the 
QUEMAN program; this may corrupt the QUEUE.SYS file. 
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A.3.2 QUEMAN Interrupt Commands 


QUEMAN recognizes interrupt commands that allow an operator, through 
the INTERRUPT command of OPSER, to get information on queue manager 
processing and to control program operation. 

Table A-6 summarizes these interrupt commands. 


Table A-6: 

QUEMAN Interrupt Commands 

Command 

Option and Meaning 

DIS[ABLE] 

QUE[UING]<text> 

SPO[OLING]<text> 

ALL<text> 

Disables QUEUING or SPOOLING or both operations with the 

ALL switch. When you specify DISABLE QUEUING, the program 
QUE stops sending messages to QUEMAN and stops listing the 
queue. Any jobs already sent to QUEMAN are processed. If you 
specify DISABLE SPOOLING, QUEMAN prevents any further 
jobs from being sent to any spooler. Jobs sent to a spooler prior to 
the DISABLE command are processed to completion. Specifying 
DIS[ABLE] ALL tells QUEMAN to terminate both QUEUING and 
SPOOLING. You can include a message to the user while specifying 
the DISABLE command. Type the command, the switch, and then 
a space followed by the message. After QUEMAN processes the 
command, it prints the <text> message in one of the following 
formats: 

ENA[BLE] 

• Further QUEUING DISABLED <text> 

• Further SPOOLING DISABLED <text> 

• Further QUEUING AND SPOOLING DISABLED <text> 

If you ignore the <text> field, QUEMAN prints the default text, "by 
operator." The message appears when you try to queue a file. 

QUE [UIN G]<text> 

SPO[OLING]<text> 

ALL<text> 

Enables QUEUING or SPOOLING or both operations with the 

ALL option. When you specify ENABLE QUEUING, the program 
QUEUE begins to send messages to QUEMAN and starts listing 
the queue. If you specify ENABLE SPOOLING, QUEMAN begins to 
send jobs to the spoolers. Specifying ENABLE ALL tells QUEMAN 
to start both the QUEUING and SPOOLING functions. Use the 
<text> field to send messages to the user. Type the command, the 
switch, and then a space followed by the text of the message. After 
QUEMAN processes the command, it prints the message in one of 
the following formats: 

• QUEUING ENABLED - <text> 

• SPOOLING ENABLED - <text> 

• QUEUING AND SPOOLING ENABLED - <text> 

The default <text> message is "by operator." The message appears 
when you try to queue a file. 


(continued on next page) 
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Table A-6 (Cont.): QUEMAN Interrupt Commands 


Command 


Option and Meaning 


END 


LAS[T] 

NEX[T] 


OFF[LINE] 


Terminates QUEMAN in an orderly manner and disables queuing 
and spooling. If any spooling programs are on line to QUEMAN, 
END sends to OPSER the informational message ’’Spoolers still 
online - will clear table” and clears the online spooler table. END 
then sends a command to OPSER that takes the QUEMAN entry 
out of OPSER tables. QUEMAN closes its work files and removes 
its job from the system. 

Sends to OPSER the most recent message generated by QUEMAN. 

quenam=reqnam Places the pending user request identified by 
reqnam at the head of the queue specified by quenam. A request 
name can contain a job name, PPN, and sequence number. Request 
names are found in the listing generated by the QUE program 
command L dev:, where dev: is the appropriate queue name. For 
example, LP:, BA:, or RJ: are valid queue names. 

Terminates QUEMAN as the END command does but does not 
generate a notification message. 


STA[TUS] 


Prints a brief report of spooling jobs on line to QUEMAN. 


When a command is received from the operator through OPSER, QUEMAN 
performs the action requested and either generates a message or an information 
line. OPSER formats the message or information line and displays it on the OSC. 
An example of this interaction between an operator, QUEMAN and the OPSER 
program is shown using the STATUS command. The following example assumes 
the operator is running the PLEASE program and the OSC is the keyboard on 
which PLEASE is running: 

# /INT #6:STATUS 
COMMAND SENT TO 'OPSER' 

# 

MESSAGE 29 : 10-MAR-90 10:48 AM JOB:6 DET QUMRUN[1,2] 

1 SPOOLER(S) ON LINE - 
(25) LP1SPL LP1: FORMS=NORMAL; 

PLEASE passes the full command line to OPSER and notifies the operator 
before it reprints the prompt. OPSER recognizes the text INT as a request to 
send unsolicited text to a spooling job. The characters "#6" in the command line 
are recognized as the number of the destination job to which the text must be 
sent. QUEMAN receives the text STATUS, generates a response, and sends the 
response back to OPSER. OPSER formats a message and displays it on the OSC 
for the operator. 

The STATUS command itself is the operator’s way of getting information about 
jobs that are on line to QUEMAN. QUEMAN’S status printout gives the number 
of spooling jobs currently on line and supplies data on each job (job number 
within parentheses, receiver identification, physical unit being spooled, and 
program default conditions). If the particular spooling job is processing a request, 
the data in the printout includes the following information about the request: its 
name, the PPN under which it is queued, and its sequence number. The STATUS 
command also tells you if SPOOLING or QUEUING is disabled. 

The NEXT command allows the operator to place a job request at the head of a 
queue. Job requests are identified by the name, account, and sequence number 
under which the request is queued. A request moved to the head of a queue is 
the next one QUEMAN sends to a spooling program servicing that queue. See 
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the RSTS/E Utilities Reference Manual for a description of the NEXT format in 
the QUE program discussion. 

If QUEMAN detects an error in the NEXT command, it generates an error 
message in the format: 

'NEXT' CMD: string - text 

The string is the command you entered. Table A-7 lists the possible error texts. 


Table A-7: NEXT Command Error Text 


Text 

Meaning 

ILLEGAL PARAMETERS 

Only a queue name and request name, 
separated by an equal (=) sign, are 

allowed in the NEXT command. 

ILLEGAL SYNTAX 

A space or an = character is missing. 

JOB IN PROCESS 

The specified job request has already been sent to 
the spooling program. 

MULTIPLE JOB SPECIFIED 

The specified request name matches two or more 
jobs in the queue. 

NO MATCH FOR JOB 

The request name does not match any job in queue. 


A.3.3 QUEMAN Startup Procedure 

You should place commands in the system startup command file to start the 
QUEMAN program. See "Creating and Using Command Files" in Chapter 3 for 
information about creating a startup command file. 

The following are typical commands to start QUEMAN: 

$ RUN OPSER$:QUEMAN 
/PRIORITY:0/RUNBURST=6 
DETACH 

The priority is set to zero because most jobs on RSTS/E rim at priority minus 
eight and QUEMAN, running at priority zero, can more readily process the queue 
file. Include the DET command to make QUEMAN run detached on your RSTS/E 
system. 


NOTE 

Without the PRIORITY switch, QUEMAN automatically sets its 
priority to zero. You can explicitly specify the switch to provide a 
record of what the program does automatically. 

Because QUEMAN examines the QUEUE.SYS file when it starts, there is no 
need explicitly to initialize the file. If the file contains bad data, QUEMAN resets 
all entries to initial states. Therefore, you should specify the INI command only 
in situations in which you want to explicitly initialize the queue file. 
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A.3.4 QUEMAN Action Under Various Startup Conditions 


QUEMAN startup actions depend on the way QUEMAN last terminated: 

• When QUEMAN runs after you shut down operator services in an orderly 
fashion through SHUTUP, a normal startup procedure occurs. QUEMAN 
finds that the QUEUE.SYS file was closed properly. The program performs 
consistency checking but does not print any messages unless it finds prob¬ 
lems. If the data is consistent, QUEMAN retains all job requests in the 
queue file and examines each request for completeness and status. Because 
QUEMAN normally starts before any spooling programs, there are no entries 
in the online spooler table. QUEMAN checks to see that this table is clear of 
entries. 

• When QUEMAN starts either after the system crashes or after QUEMAN 
itself terminates unexpectedly, it finds the queue file improperly closed and 
generates a message to that effect. The program performs consistency check¬ 
ing on the queue file structure and on the data in the QUEUE.SYS file itself, 
generates messages telling the results, and reestablishes communication with 
all spooling jobs. 


A.3.5 QUEMAN Consistency Checking 

The QUEUE.SYS file has room for 250 queued requests. QUEMAN creates an 
entry for a queued request from an entry in a free list. A request for a line 
printer or batch queue requires one entry from the free list. A request queued 
with an AFTER date and time, however, requires two entries from the free list — 
one for the proper queue and one for the AFTER queue. 

In performing consistency checking on the QUEUE.SYS file, QUEMAN initializes 
all entries if it finds one of the following conditions: 

• An entry in the free list is also in a queue or AFTER list 

• The root of the free list is outside the legal range 

• A request queued with an AFTER date and time that has not expired does 
not have an entry in the AFTER queue 

For other inconsistencies, QUEMAN either may remove a single entry or perform 
some related action. If an entry in the AFTER queue has no corresponding entry 
in a spooling queue, QUEMAN removes the AFTER entry. If an entry in either 
an AFTER or spooling queue is not completely set up, the program removes the 
entry. (QUEMAN may have terminated while it was processing the request.) To 
signal this event, QUEMAN generates a message in the format: 

%LPn: 'reqnam' [p,pn]/QUEUED JOB INCOMPLETE - REMOVED FROM QUEUE 

If an entry to be killed still remains, QUEMAN removes it and generates a 
message in the format: 

%LPn: 'reqnam' [p,pn];QUEUED JOB IN 'KILL' STATUS - REMOVED FROM QUEUE 

If QUEMAN finds that an entry has been processed (sent to a spooling program) 
but not yet completed, it places the request in a hold status and generates text in 
the format: 

%LPn: 'reqnam' [p,pn];JOB PREVIOUSLY SENT TO SPOOLER; 

WILL BE PUT INTO HOLD STATUS 

The requester can remove the job request from hold status. 
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QUEMAN checks the online spooler table in the QUEUE.WRK file for consistency. 
If the program finds the table empty, it generates the informational message: 

# SPOOLERS ON LINE = 0; WILL CLEAR TABLE 

If the program finds that the count of online spooling jobs is larger than the limit 
(16), it clears the table and generates the informational message: 

ONLINE SPOOLER TABLE CORRUPT - WILL CLEAR TABLE 

If QUEMAN clears the online spooler table but spooling jobs are still running, 
the operator must terminate those jobs through OPSER and restart each spooling 
program. This action allows QUEMAN to put each spooling job on line again 
properly. 

For each spooling program found in the online job table, QUEMAN removes the 
entry and generates the informational message: 

'rcvrid' (nn) FOUND ON LINE TAKEN OFF LINE 

QUEMAN sends the job a message requesting that it declare itself on line to 
QUEMAN again. The spooling job does not respond to the message while it is 
processing a queued request. The answering message indicating that the job is 
again on line to QUEMAN does not appear until the job completes the current 
request. When QUEMAN receives the online declaration from a spooling job, it 
generates the informational message: 

'rcvrid' (nn) PUT ONLINE 


A.4 Line Printer Spooling Program: SPOOL 

The line printer spooling program SPOOL runs without operator intervention and 
executes queued requests to transfer disk files to a line printer or terminal. The 
program consists of these modules: 

• SPOOL — Establishes initial conditions on startup and checks initial 
conditions upon restart 

• SPLIDL — Executes when no job is being printed 

• SPLRUN — Prints any spooled file 

Each module is stored in the OPSER package account OPSER$:, has a protection 
code of <232>, and requires SWCFG privilege to run. For simplicity, this 
appendix refers only to one program, SPOOL, which functionally includes the 
three modules. 

The SPOOL program rims only if the user has SWCFG privilege and the OPSER 
and QUEMAN programs are running. To start SPOOL, type the following 
command while logged in to the system under an account with SWCFG privilege: 

$ RUN OPSER$:SPOOL 

SPOOL V10.0 RSTS V10.0 TIMESHARING 

• 

Typically, this is done in the system startup file. 

At this point, the SPOOL program performs a number of preliminary checks 
before it prints the number sign (#) prompt. The remaining portion of this section 
describes these initial program checks. Once you are familiar with this procedure, 
you can then learn the options SPOOL accepts in response at its program prompt. 
A description of these SPOOL program checks follows. 
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If you do not have SWCFG privilege, the system displays an error message to 
indicate that you do not have access to SPOOL. 

If the job has SWCFG privilege, SPOOL runs and prints its identification line 
and the # prompt. In response to the prompt, give a specification in the following 
format: 

# logical device:/startup switch(es) 

The logical device is the name of the queue and the unit number within that 
queue from which this copy of SPOOL takes job requests to execute. This 
name ordinarily corresponds to the physical device on which SPOOL prints 
the requests; the physical device, however, may be changed by the PHYSICAL 
startup option (see the following section "SPOOL Startup Options"). 

The logical device name must have the form LPn: or LP:, where n is a unit 
number from 0 to 7. If the name is LPn:, the spooling job prints only requests 
queued either to that explicit unit or to the general spooling queue LP:. If you 
specify LP:, this copy of SPOOL prints requests in the printer queue regardless 
of the unit to which they were originally queued. The logical device specified as 
the queue name must be a line printer; the device name given must not have a 
logical assignment to some other device. 

NOTE 

The general spooling queue LP: is useful only on systems having line 
printers with similar characteristics. 

You can use any combination of the startup switches described in the following 
section to condition the operation of the SPOOL program. A switch is formed by 
a slash (/) character and an option that may take an operand or other switches. 


A.4.1 SPOOL Startup Options 

Startup options alter default processing conditions. You use these options to: 

• Spool output to a different physical device 

• Change form information 

• Control job environment 
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Table A-8 summarizes these options. Note that the symbol (_) is an underline 
character and not a space. 

Table A-8: SPOOL Startup Options 

Option Syntax and Meaning 

ASSIGN /ASS[IGN] 

Reserves the physical device for this job. Without this option, SPOOL 
retries continually whenever it cannot gain access to the unit and is 
ready to print a job. 

FORM /FOR[M]:name switch 

Defines the current form according to a name (NORMAL is the 
default name) and switches as follows: 

• /ALI[GN] 

Causes SPOOL to execute a forms alignment procedure before 
processing any further queued requests. 

• /DFL[ENGTH]:nnn 

Declares the device form length as nnn lines, where nnn is a 
number from 1 to 127. The length is that understood by the 
hardware of the output device. For example, on a line printer 
in the United States, the standard length is usually 66 lines per 
page. 

• /HEA[DINGS]:n 

Causes SPOOL to print n (from 0 to 3) heading burst pages 
preceding each job request. Unless /NH accompanies a file 
specification in the QUE command, SPOOL also prints n burst 
pages preceding each file in a job request. The default value is 1. 

• /LEN[GTH]:n 

Defines the length of software form as n lines per page, where n 
is a number from 1 to 127. If this switch is not given, SPOOL 
assumes 66 lines per page. 

• /PAG[E_EJECT]:YES 

Indicates that the device to which this copy of SPOOL directs 
output has a hardware top of form capability and that the device 
interprets the formfeed character (ASCII 12) as a top-of-form 
command. This condition is the default case for line printer 
devices. 

• /PAG[E_EJECT]:NO 

Conditions the software to translate a formfeed character (ASCII 
12) into the proper number of linefeed characters because the 
hardware does not recognize the character as a top-of-form 
command. This condition is the default case for SPOOL output 
directed to terminal devices by the PHYSICAL option. 

• /WID[TH]:n 

Defines the width of the heading burst page as n characters per 
line. The default value is 132. 

LPFORM /LPF[ORM] :YES 

Indicates that LPFORM characters are interpreted by the system 
software for the output device. During normal transfer, the program 
passes LPFORM characters unmodified to the device. This condition 
is the default for line printer devices. 


(continued on next page) 
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Table A-8 (Cont.): 

SPOOL Startup Options 

Option 

Syntax and Meaning 


/LPF[ORM]:NO 

Indicates that the system software does not interpret LPFORM 
characters. During normal transfer, the program converts each 
LPFORM character to an appropriate number of line feed characters. 
This condition is the default for terminal devices. Note that this 
option affects only jobs queued with the /LPFORM switch. The 
SPOOL program does not automatically invoke /LPFORM processing. 

NAME 

/NAM[E]:rcvrid 

Places the specified identification in the system message receiver 
table and in OPSER’s online job table. This identification rather 
than the default identification is used by the operator in OPSER 
commands to access this spooling job. This identification must not be 
in use by some other job. 

PHYSICAL 

/PHY[SICAL] :dev: 

Uses this device as the physical device for this spooling program. 
Requests in the queue specified by the logical device are printed on 
this device. The default value is the logical device specified as the 


queue name. 

PRIORITY 

/PRI [ORITY]: nnn 

Sets the job priority to nnn, where nnn is a number from -120 to 

120. Without this option, the priority remains as set by LOGIN. 

You must have TUNE privilege to specify this qualifier. Do not use 
/PRIORITY after a /FORM, /NAME, or /PHYSICAL option, or after 
an LPn: designator. 

RUNBURST 

/RUN[BURST]:nnn 

Sets the job run burst to nnn, where nnn is a number from 1 to 127. 
Without this option, the run burst remains as set by LOGIN. You 
must have TUNE privilege to specify this qualifier. 


The PHYSICAL option alters the physical device on which queued requests are 
printed. For example, requests queued for line printer unit 1 could be processed 
on another line printer unit or on a keyboard unit. In any event, the actual 
device differs from the one for which the requests were queued. 

The ASSIGN option reserves the actual spooled device to the job. Without this 
option, SPOOL periodically tries to gain access to the spooled device whenever 
SPOOL is ready to print and another job has ownership of the device. When 
SPOOL terminates, it deassigns the device. 

The NAME option allows the receiver identification to be different from that 
normally assigned by SPOOL. The identification should be from one- to six- 
alphanumeric characters and must not exist in the system message receiver 
table. The identification must not begin with a number because the operator uses 
either this identification or a job number to identify a spooling job. 

The FORM option allows the default form information to be altered. For example, 
individual characteristics of the NORMAL form can be altered, a new form 
with a different name can be defined, or a forms alignment can be requested. 

A forms alignment can be requested by itself or in conjunction with a form 
alteration. When a form name other than NORMAL is in effect, user’s queuing 
requests must explicitly specify the form name to have files printed with its 
characteristics. 


A--24 Managing the OPSER Spooling Package 






To alter the default characteristics of the NORMAL form, the operator can specify 
the appropriate auxiliary switches without the /FORM: switch. For example, to 
change the number and width of heading burst pages for line printer unit 0, type: 

LP 0:/HEADINGS:2/WIDTH:8 0 

When executed, this command causes SPOOL to output two heading burst pages 
with a width of 80 characters per line print for each job request and each file 
within a request. The width used applies only to the burst pages, not to the data 
being printed. 

Specifying a form with a name other than NORMAL usually means that the 
operator must load special paper in the output device. The /ALIGN switch with 
the FORM option requests a forms alignment. The operator then must align the 
form at system startup time. A SPOOL interrupt command with the /ALIGN 
switch can request a form alignment during timesharing. The section "Changing 
and Aligning Forms" describes the forms alignment procedure. 

The following message can occur when the line printer queues are empty, but jobs 
with nondefault form names exist: 

NO JOBS WAITING WITH FORMNAME 'XXXXXX' FOR SPOOLER 'LPn:' 

OTHER JOB(S) WAITING. 

***PLEASE INSPECT QUEUE AND TAKE APPROPRIATE ACTION* ** 

The operator must then decide whether or not to use an interruption command to 
change the form name so the other jobs can be queued. 

The PAGE_EJECT option determines whether the SPOOL program counts lines 
to effect forms control. (The DFLENGTH option can modify the effect of the 
PAGE_EJECT option.) A value of NO with the PAGE_EJECT option indicates 
that the output device (driver) does not understand a form feed character; that 
is, a form feed character does not cause the device to position itself at top of 
the (paper) form. With NO in effect, SPOOL counts lines to effect forms control. 

A response of YES with the PAGE_EJECT option indicates that the device 
(hardware) translates the form feed character to an appropriate number of line 
skips to place the device at top of form. With YES in effect, SPOOL need not 
count lines and may be able to pass all forms control data unaltered to the device 
driver. (The DFLENGTH option can modify the effect of YES.) 

NOTE 

SPOOL issues three forms-control characters: 

• Form feed character (ASCII 12) 

• Carriage return character (ASCII 13) 

• Line feed character (ASCII 10) 

No other forms-control characters are used. SPOOL has no provisions 
for changing or extending the set of control characters for any special 
device(s). 

The terms line feed and line skip are not synonymous. Line feed refers 
only to the line feed character, which either SPOOL or the device driver 
sends to a device. Line skip refers to the movement of paper that the 
device itself effects. 

If NO is in effect for the PAGE_E JECT option, SPOOL ignores any value specified 
in a DFLENGTH option. The operator should specify /PAGE_EJECT:YES for any 
terminal device that has a top-of-form capability. 
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SPOOL uses the value specified in the DFLENGTH option only if /PAGE_ 
EJECT:YES is in effect. The /PAGE_EJECT:YES switch can be in effect either 
through default (on a line printer) or by explicit specification (for a terminal de¬ 
vice having the form feed capability). The operator may specify the DFLENGTH 
option either at startup time in a SPOOL startup switch or during processing in 
a FORM interrupt command. For proper formatting, the DFLENGTH value must 
be the maximum number of lines that the output device skips when it receives a 
form feed command. The number of lines is called the device form length. This 
number may differ from the length of the paper form being used. 

Different devices have different form lengths. Three examples can show how the 
device form lengths vary: 

• The LA180 device has a switch labeled "Length of Form," which has settings 
for 4, 8.5, and 11 inches. These settings correspond to 24, 51, and 66 lines 
per form. (The number of lines per form given for each setting assumes the 
standard 6 lines per inch on the LA180.) If, when starting the spooling job, 
the operator sets the switch on the LA180 to 8.5 inches, the operator should 
also specify the DFLENGTH switch with a value of 51. If, at some later 
time, the operator changes the setting on the LA180 to 4 inches, the operator 
should also specify a new DFLENGTH option with a value of 24 in a FORM 
interrupt command to the spooling job. 

• Many line printers have only one form length. If the hardware length is 
66, the value in the DFLENGTH switch should be 66. If the hardware form 
length is 51, the operator should specify DFLENGTH=51 when starting the 
spooling job. (The default value for DFLENGTH is 66.) 

• Some printing devices have an adjustable top-of-form. On these devices, 
the operator can adjust the device to execute an arbitrary number of line 
skips when it receives a form feed character. This adjustment is made most 
often on terminal-type devices with high quality print characteristics. When 
resetting the top-of-form for this type of device, the operator should also 
specify the DFLENGTH and LENGTH options with the new form length 
information. The operator should also request a forms alignment for each 
new form. 

The effect of the DFLENGTH option on the SPOOL program differs for line 
printers and terminal devices: 

• For a line printer, the DFLENGTH value affects only the procedure SPOOL 
invokes when it receives an ABORT command while it is processing a job 
request. If the DFLENGTH value equals the current length of paper form, 
the program issues a form feed character to position the device at the top of 
the next form. If the values are not equal, the program automatically invokes 
the forms alignment procedure to reestablish the top-of-form position. 

The automatic forms alignment procedure requires operator action to align 
the form and to respond to requests SPOOL makes. This is necessary only 
when the program has no way to determine where the top-of-form lies after 
an ABORT operation. 

• For a terminal, the DFLENGTH value controls the way SPOOL keeps its 
place on a form and the way the operator handles recovery procedures. If 
the value of the PAGEJEJECT option is YES, the equality of the device form 
length and the paper form length is important. If the device form length 
and paper form length values are not equal, the SPOOL program counts 
lines to maintain a record of its position on a form and issues an appropriate 
number of line feed characters to simulate form feed. If these values are 
equal, SPOOL does not count lines and simply sends a form feed character to 
position the paper at top-of-form. 
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NOTE 


A line printer is a device whose interface to the computer is through 
a line printer controller and whose designation is in the form LPn:. 

A terminal is a device whose interface to the computer is through 
a keyboard line and whose designation is in the form KBn:. This 
distinction is critical because some devices such as the LA180 are 
called printers but may be connected to the computer through a 
keyboard line. 

If the value in effect for DFLENGTH does not correctly match the setting of the 
hardware device, two undesirable conditions exist: 

• SPOOL must incur the overhead of counting lines. 

• Forms alignment may be lost during processing. 

For these reasons, Digital highly recommends that the operator supply a new 
value of DFLENGTH when changing the hardware setting on the device. 


A.4.2 Line Printer Spooling 

If the physical device specified at startup time is a line printer unit, SPOOL 
applies the default values. Table A-9 lists these default values. 


Table A-9: SPOOL Line Printer Default Values 


Switch 

Result 

/DFLENGTH :66 

The device form length is 66 unless otherwise specified. If 
you have patched the monitor to apply a different default 
form length, you must always specify the correct value in a 
DFLENGTH option. 

/FORM:NORMAL 

The values shown are used as the form definition. 

/HEADINGS: 1 
/LENGTH:66 
/WIDTH: 132 


/LPFORM:YES 

For any line printer, SPOOL assumes that the device driver 
properly processes the special LPFORM characters (see the 
RSTS/E Programming Manual). 

/PAGE_EJECT:YES 

For any line printer, SPOOL assumes that the device driver 
properly processes top of form characters. 


You can also set the characteristics of a line printer with the SET PRINTER 
command (see Chapter 11). 
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A.4.3 Keyboard Spooling 

If the physical device specified at startup is a keyboard device, SPOOL applies 
the default values. Table A-10 lists these default values. 


Table A-10: SPOOL Keyboard Default Values 


Switch 

Result 

/DFLENGTH:66 

DFLENGTH has no effect unless PAGE_EJECT is explicitly 
specified as YES. 

/FORM:NORMAL 
/HEADINGS: 1 
/LENGTH:66 
/WIDTH:132 

The values shown are used as the form definition. 

/LPFORM:NO 

The terminal driver does not process LPFORM characters. 
For any file that contains LPFORM characters, SPOOL 
simulates the LPFORM effect by issuing linefeed characters. 

/PAGE__EJECT:NO 

Most terminals do not have a hardware top-of-form capability. 
SPOOL simulates top-of-form by issuing the correct number 
of linefeed characters. 


For terminals with the hardware top-of-form capability: 

• Set the value of PAGE_EJECT to YES. 

• Set the value for DFLENGTH to the actual device form length (see "SPOOL 
Startup Options"). 

• Set the proper characteristic of the device that accepts and processes a form 
feed. Use the SET TERMINAL command to perform this operation (see 
Chapter 8). 


A.4.4 Startup Error Processing 

If you make an error when responding to the number sign (#) prompt, SPOOL 
prints a message and the unparsed command line in the format: 

TERROR MESSAGE 
unparsed command line 
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The unparsed command line is the right-hand part of the response beginning at 
the element causing the error. Table A-ll summarizes the possible messages. 

Table A—11: SPOOL Syntax Error Messages 

Message and Meaning 
?Can’t parse remaining string 

Something illegal or undefined was found in the command line. An unde¬ 
fined switch or missing slash (/) character causes this error. 

?Duplicate switch 

Two occurrences of the same switch were found in the command line. 

?Illegal logical device 

The logical device specified was not in the form LP: or LPn: (where n is a 
number from 0 to 7). 

?Illegal operand 

An illegal operand was found in an option or switch. For example, specifying 
nonnumeric characters in a switch that requires a number (/WIDTH:n) 
generates this error. 

?Illegal physical device 

The device specified in the PHYSICAL option is not a line printer or 
keyboard device. 

?Missing operand 

A switch requiring an operand was specified without one. For example, 
if a receiver identification is missing from the NAME option, this error is 
generated. 


If SPOOL encounters no syntax errors in the response, it begins setting initial 
conditions. SPOOL reports errors in this phase by printing a message in the 
format: 

ERROR IN SOME OPERATION - RESTARTING 

error message 

The program reprints its identification line and the prompt. 

An error message ?Duplicate receiver ID means that the receiver identification, 
either the default one or the one specified in a NAME option, is already defined 
for another job. The operator should type the command line again and specify a 
unique receiver identification in the NAME option. 

The error message ?No room in receiver table means that a general small buffer 
is not available to let SPOOL declare itself a receiving job. A later retry with the 
same command line should succeed. 

The following message means that SPOOL attempted to send a message to that 
program and failed: 

*****0PSER HUNG* * * * ***** or *****QUEMAN HUNG***** 

Either the named program does not have an entry in the system message receiver 
table or the program is not processing its messages and its message limit has 
been reached. The operator must determine the cause of the problem and restart 
the named program. 
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A.4.5 SPOOL Interrupt Commands 


The operator communicates with a SPOOL job by means of INTERRUPT 
commands sent through the operator services program OPSER. Note that any 
responses to an INTERRUPT command are displayed on the Operator Services 
Console. 

Table A—12 summarizes these SPOOL interrupt commands. Note that the 
circumflex ( A ) character marks the location of a required space. 

Table A-12: SPOOL Interrupt Commands 


Command Syntax 

Meaning 

ABO[RT] 

Immediately terminates the current process and removes the 
request from the queue. 

CON[TINUE] 

Wakes up the spooling job to continue processing after a 
PAUSE command. 

END 

Closes out processing after completing the current request. 

The operator must then run the spooling program again to 
process further requests. 

FOR[M] A name/switch 

Changes the current output form to one identified by name 
and defined by switches. These switches change current form 
characteristics; those characteristics not changed by an option 
remain at their current definitions. See the startup option 
FORM description in Table A-8 for the allowable options. 
Alignment is done only if the /ALIGN switch is included. 

FOR[M] 

Displays characteristics of the current form if no name or 
options are in the command. 

FOR[M] A /ALIGN 

LAS[T] 

OFF[LINE] 

Requests a forms alignment procedure for the current form. 
Prints the most recent message generated by the spooling job. 

Immediately terminates all processing by this spooling job 
(same as ABORT followed by END). 

PAU[SE] 

Places the spooling job in a sleep state, during which it 
responds to most commands and resumes normal processing in 
response to a CONTINUE command. 1 

REQ[UE] 

Stops processing the current request and replaces the re¬ 
quest in the queue so that processing later resumes at the 
terminating point. 

RES[TART] 

Reprints the current copy of a file from the beginning, includ¬ 
ing heading burst pages. 

RES[TART] A JOB 

Reprints the current iteration of the job, including heading 
burst pages. 

RES[TART] A :n 

Reprints the current copy of the file starting at page n. If n is 
0, restarts from the beginning of the file but omits the heading 
burst pages. 

STA[TUS] 

Prints a status report for the spooling job. 


1 Note that processing continues if any job modification command such as ABORT or REQUE is sent. 
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A.4.6 SPOOL Startup Examples 

This section shows examples of the startup procedure. They represent typical 
cases. 

A.4.6.1 Line Printer Startup with All Defaults 

In response to the SPOOL program prompt, the operator types: 

• LPO: 

If SPOOL finds no errors, it prints the message: 

DETACHING... 

SPOOL detaches itself and leaves the terminal logged off the system. 

The following are the characteristics of this copy of SPOOL: 

• The program prints only job requests that were queued to line printer unit 0 
with a form name of NORMAL or queued to the general line printer queue 
with a form name of NORMAL. 

• The program prints on line printer unit 0. 

• The program prints one heading burst page before each job and, unless a file 
is queued with /NH, prints one heading burst page before each file. The width 
of the burst page is 132 columns, and the form length is 66 lines. 

• The program assumes the device driver handles LPFORM characters. 

• The program assumes the device handles top-of-form. 

• The program assumes the device form length is 66 lines. 

• The rim burst and priority of SPOOL are those in effect when the job starts. 

• When the program receives a job from QUEMAN, it attempts to assign the 
printer. If the assignment fails, the program retries periodically until it 
succeeds. When it finishes processing a job request, the program deassigns 
the device. 

The operator may later change all form characteristics (name, length, width, de¬ 
vice form length, and headings count) through appropriate interrupt commands. 

A.4.6.2 Line Printer Startup with Narrow Width 

In response to the prompt, the operator types the command line: 

• LPl:/FORM:NARROW/WIDTH:80/RUNBURST:12/ASSIGN 

The following are characteristics of this copy of SPOOL: 

• The program prints only jobs queued with a form name of NARROW and 
queued to either unit 1 or the general line printer queue. 

• The program prints on the line printer 1 device. 

• The program prints one heading page of width 80 columns; form length is 66. 

• The program assumes the device handles top-of-form. 

• The program assumes the device driver handles LPFORM characters. 
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• The program assumes the device form length is 66. 

• The priority of the job remains unchanged. The program sets the run burst to 

12 . 

• The program does not begin spooling until it can assign line printer unit 1 
and does not deassign the device until it terminates. 

In this example, assume that line printer unit 1 is a relatively slow device and 
that the SPOOL program can generate output data for this unit faster than the 
device can print. Optimal use of the device results if the unit keeps running at 
full speed for the entire job request it is printing. 

To effect optimal use, it is sometimes necessary to raise either the priority or run 
burst of the SPOOL program. The priority of a job generally affects how often 
it runs, whereas the run burst affects the length of time the job runs once it 
starts running. Because the SPOOL program is usually I/O bound and waiting 
for the device to complete printing, there is little reason for it to run more often. 
Changing the priority is usually unnecessary and ineffective. Changing the run 
burst, however, may improve processing. 

When SPOOL starts executing, it remains in the run state until one of the 
following events occurs: 

• The job’s run burst expires. That is, the job actually executes for its full rim 
burst. 

• The job requests some type of I/O and the system cannot immediately satisfy 
the request. 

For the spooling program, the second event is much more likely because the 
system buffers only a fixed amount of data before it refuses to satisfy further 
requests for output. When the refusal occurs, the system activates another job 
and the spooler must wait until the system sends at least some of the already 
buffered data to the output device. (This wait condition shows as an LP or TT 
STATE on a SYSTAT listing.) 

As long as the buffers for the device are never completely emptied, the system 
keeps the device running at or near full speed. To a certain point, raising the 
spooling job’s run burst makes it more likely that the job will continue running 
until it completely fills the buffers for its output device. After a certain point, 
raising the run burst has little benefit because the job can run only until the 
buffers are full. Conversely, decreasing the run burst causes the system to 
deactivate the program before the buffers are full. It is more likely that the 
printer can empty the buffers before the system reactivates the job. 

If a spooling job spends a significant time in the RN state while it is actually 
printing, the run burst is too low. Digital recommends that you raise the run 
burst to a value at which the job spends most of its time in an output wait state. 


A.4.6.3 Keyboard Startup on an LA36 

For this example, assume that keyboard unit 5 is an LA36 terminal. At the 
prompt, the operator types a command line as follows: 

• LP2:/PHYSICAL:KB5:/HEADINGS:O/ASSIGN 

The following are the characteristics of this copy of SPOOL: 

• The program prints only jobs queued with a form name of NORMAL and 
queued to the unit 2 or the general line printer queue. 

• The program prints on keyboard unit 5. 
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• The program prints no heading burst pages. The form length is 66. 

• The program assumes that keyboard unit 5 does not handle top-of-form; 
therefore, it counts lines as it prints them to simulate top-of-form. 

• The program assumes the device driver does not handle LPFORM characters; 
therefore, it simulates LPFORM with line feeds. 

• The run burst and priority remain unchanged. 

• The program assigns keyboard unit 5 at startup and keeps it assigned until it 
terminates. 

Because the LA36 is a slow device, processing is not slowed any further with 
burst pages. The /HEADINGS:0 switch suppresses printing of burst pages. 

To retain any forms alignment on the LA36, the device is permanently assigned 
to the spooling job. This assignment prevents any other job from using the device 
and leaving the carriage at a position other than the top of form position. When 
the spooler starts processing a request, it must assume the device is at its top of 
form position because the program has no way to force the device to advance to 
some known position. If the form is not aligned properly when SPOOL starts the 
output, the entire output is misaligned. 


A.4.6.4 Keyboard Startup on an LAI 80 

For this example, keyboard unit 2 is a serial LA180 DECprinter. This terminal 
has a hardware top-of-form capability. In addition, the form length selector switch 
on the terminal is set to 8.5 inches (51 lines per form) and the paper form is also 
51 lines per page. 

In response to the prompt, the operator types a command line as follows: 

• LP3:/PHYSICAL:KB2:/PAGE_EJECT:YES/DFLENGTH:51/LENGTH: 51- 

MORE> /WIDTH:40/FORM:SPECIAL 

The following are the characteristics of the SPOOL copy: 

• The program prints only requests queued with a form name of SPECIAL and 
queued to either the unit 3 or the general line printer queue. 

• The program prints on keyboard unit 2. 

• The program prints one heading page that is 40 columns wide and 51 lines in 
length. 

• The program assumes the device handles top of form. 

• The program assumes that the device driver does not handle LPFORM 
characters. The program therefore simulates LPFORM with line feeds. 

• The rim burst and priority remain unchanged. 

• The program assigns the keyboard before it prints each request and deassigns 
it after printing the request. The reasons for doing this are: 

— The LA180 is a much faster device than the LA36, SPOOL can print a 
small number of burst pages to simplify distinguishing jobs and files. The 
narrowest width for the burst page is 40 columns. 

— The paper form length and the device form length are equal, SPOOL can 
position the device to top-of-form by issuing a form feed character. 

— The program can position to top-of-form, it does not need to keep the unit 
assigned. 
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The ASSIGN option, therefore, does not appear in the example. If the paper form 
length did not equal the hardware setting, however, SPOOL should keep the 
device assigned to preserve the top-of-form position. 


A.4.6.5 Using Two or More Printers to Serve a Queue 

It is possible to have two or more printers serve a single print queue. For exam¬ 
ple, you can have two printers serve the LPO: queue, which is the default queue. 
Ordinary, print jobs (those queued to LPO:) are printed on either printer. 

This feature is most useful when you have two or more similar printers in the 
same physical area. It is not generally useful to have a fast and a slow printer 
serve the same queue, nor to have two printers in different locations serve the 
same queue. 

A different form can be mounted on each printer. If this is done, the spooling 
package automatically selects the printer that has the correct form for a par¬ 
ticular job. Or, if the correct form is not mounted on any available printer, the 
spooling package holds the job. 

Start up each spooler by running the SPOOL program. Specify the same queue 
name for each printer. For example, specify LPO: if the spoolers are to serve the 
LPO: queue. However, you must use the /NAME:rcvrid switch to ensure that each 
spooler is given a different receiver ID. Otherwise, the SPOOL program prints 
the message "?Duplicate receiver ID." 

In the following example, the devices LPO: and LP1: both serve the queue named 
LPO:. 

RUN OPSER$:SPOOL 

# LPO:/NAME:LPO/PHYSICAL:LPO: 

Detaching ... 

RUN OPSER$:SPOOL 

# LPO:/NAME:LP1/PHYSICAL:LP1: 

Detaching ... 

Tb avoid confusion, a queue should not have the same name as a printer that 
serves another queue. For example, if queue LPO: is served by printers LPO: and 
LP1:, do not name another queue LP1:. 


A.4.7 Recovery from Line Printer Errors 

The interaction between the spooling job and the OPSER program controls error 
handling in the SPOOL program. For example, if the paper runs out or jams, 
SPOOL receives the error message: 

?Device hung or write locked 

SPOOL discontinues processing and sends OPSER a message. OPSER generates 
a message for the operator: 

MESSAGE 3 : 28-MAR-90 04:33 PM JOB:21 DET SPLRUN[1,100] 

LPO : HUNG - JOB: [220,40]USER1 

(PUT DEVICE ONLINE TO CONTINUE) 

The message tells the operator that the spooling job for line printer unit 0 has a 
problem and that the device needs to be made ready again before processing can 
continue. 
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For a SPOOL program servicing a line printer, there are certain errors from 
which you can easily recover. The device handler for the line printer tests the 
ready status of an offline unit every 10 seconds. If the operator corrects the 
error (for example, fixes a paper jam) and puts the line printer on line again, 
the software detects the ready status and continues printing buffered characters. 
The SPOOL program finds that the error condition is cleared and continues 
processing. 

If a special form is being processed and SPOOL receives an error, SPOOL may 
request the operator to realign the forms before it continues processing on its 
own. 

If the operator cannot correct the error or wants to perform some other operation, 
the spooled device may be left off line. This prevents the software from reprint¬ 
ing before the program processes an operator request. The operator uses the 
INTERRUPT command with the proper text to access the spooling job. 

SPOOL allows the operator several ways to control the restart of a queued 
request. The RESTART command can restart: 

• The current copy of a queued request (RESTART JOB) 

• The current copy of a file in a queued request (RESTART) 

• The current copy of a file at a specific page (RESTART:nnn) 

The REQUE command can reenter the current job in the queue for later process¬ 
ing. On receiving a RESTART command, the program waits for any currently 
buffered data to be printed before actually restarting. 

The REQUE command causes SPOOL to remember the point at which processing 
was interrupted. After resuming the requeued request, SPOOL scans for the page 
on which processing terminated and continues printing at the start of that page. 
An error may occur if a user modifies the requeued request before SPOOL can 
resume the printing. 

If the operator responds to an error condition with an ABORT command, which 
terminates the job, SPOOL clears the output buffers on the line printer unit. If 
the device is a terminal, SPOOL prints any buffered data. The program then 
issues a message to show that it is terminating. 

Before terminating a queued request, the SPOOL program makes sure that all 
buffers have been emptied successfully. 


A.4.8 Line Printer Output 

SPOOL generates job header and file header burst pages to identify print requests 
and files within a print request. Both types of header page contain identification 
and general accounting information as follows: 

• The identification consists of large, easily-readable block letters created from 
the character generation file CHARS.QUE. The job identification contains the 
account number of the user requesting the job and the name of the job. If no 
job name appeared in the QUE command, SPOOL prints the name of the first 
file in the request as the job name. The file identification shows the file name 
and type. 
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• General accounting information for the job header is on the burst page 
and is offset from the identification by two rows of special characters. The 
accounting information contains five lines of data: 

— The first line gives the job name, current date, current time of day, and 
the requester’s account number. 

— The second line gives the date and time of day of the request and the 
device for which the request was queued. 

— The third line gives the system name. 

— The fourth line gives the QUE options used to process the request. 

— The fifth line gives the job copy number. 

The accounting information for the file header burst page appears below 
the identification and is framed (above and below) by two rows of special 
characters. The first line of information gives the job name used when 
SPOOL printed the file and shows the current date, time of day, and account 
as the job header burst page does. The second line gives the copy number, the 
QUE options used on the file, and the complete specification of the file. The 
third line gives the record type and carriage control format used to print the 
file. 

If SPOOL does not print the file because of an error, file header identification and 
accounting information is replaced by an error message framed (above and below) 
by five rows of special characters. The error message is standard RSTS/E error 
text. 


A.4.9 Error Messages During User Output 

SPOOL reports errors it receives during printing in the line printer output. 
SPOOL differentiates the error message from requested output by framing the 
text (above and below) with five rows of special characters. 

Table A-13 shows the possible SPOOL error messages and related meanings. 

Table A-13: SPOOL User Requested Output Error Messages 


Message and Meaning 

?Can’t find file or account 

The related file was deleted between the time it was queued and the time 
SPOOL tried to print it. 

?File restart requested on page n 

The operator requested a restart at the indicated page or placed the job 
request back in the queue with the REQUE command. If the operator 
restarted the job request, SPOOL scans the file to find the correct page and 
continues printing on a new page following the message. If the operator 
requeued the job, this message appears when SPOOL restarts the job. 

?Job aborted 

Either the operator terminated the job request with an ABORT command 
or the K command of the QUE program was issued while the job was being 
printed. 


(continued on next page) 
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Table A-13 (Cont.): SPOOL User Requested Output Error Messages 


Message and Meaning 


?Job aborted because of file error(s) 

Errors in some file in the job prevented SPOOL from printing the remainder 
of this job. 

?Job requeued at page n 

The operator placed this job request back in the queue with the REQUE 
command. SPOOL later continues the job request with a new header burst 
page and the text FILE RESTART REQUESTED ON PAGE n, where n is 
the same page number shown in the REQUE message. 

?<error text> 

SPOOL encountered the RSTS/E error shown, aborted processing the 
request, and cleared the request from the queue. 


A.4.10 Changing and Aligning Forms 

The FORM command can do the following: 

• Inform the spooler of a change in form on its device 

• Request an alignment operation on the device 

• Display information about the current form 

Switches with the command specify the new form definition and request align¬ 
ment. The command may request alignment when a new form is specified. 

To request a form change, the operator sends the FORM command with the 
form name and the switches to define the form to the related spooling job. If an 
alignment is wanted for the current form, the operator can include the /ALIGN 
switch with the FORM command. The SPOOL program does not recognize the 
form change request until it becomes idle. If it is processing a queued request, 
it completes the processing before it performs the forms change. (To make the 
change immediately, request that SPOOL requeue the current request. The 
program requeues the request and becomes idle.) 

To perform only an alignment, specify the FORM command without any form 
name and with only the /ALIGN switch. Again, the command takes effect only 
when SPOOL becomes idle. The program follows these steps: 

1. Prints characters to delineate left and right margins, and prints the text TOP 
OF FORM centered on the same line. 

2. Generates characters to position the paper on the last line of the form. 

3. Prints characters to delineate the left and right margins, and prints the text 
END OF FORM centered on the same line. 

4. Positions the paper at top of the next form. 

SPOOL generates an action request and awaits a response. The operator may 
inspect the alignment and type one of two responses to the action request. If 
the alignment is not correct, the operator can adjust the hardware and send 
the response RETRY back to the spooler. In response to RETRY, the spooler 
performs steps 1 through 4 again and generates another action request. When 
the alignment is accurate, the operator types GO as a response to the action 
request. The spooler returns to normal processing. 
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Whenever SPOOL processes any FORM command, it sends a message to the 
operator indicating that the new form characteristics in effect. In any FORM 
command, only those options specified in the command change the form charac¬ 
teristics. Thus, if the operator sends a FORM command alone, without a form 
name or any options, the spooler displays the characteristics of the current form 
on the Operator Services Console. 


A.5 Batch Processor Program: BATCH 

The BATCH system program runs without user intervention on pseudokeyboards 
and executes files of standardized commands queued for either a specific or the 
general Batch Processor. The program consists of four modules: 

• BATCH sets initial conditions for batch processing. 

• BATIDL checks status when no requests are being handled. 

• BATDEC decodes and performs error checking on command files. 

• BATRUN executes the decoded batch commands. 

For simplicity, this appendix refers only to one program, BATCH, which 
functionally includes the four modules. Each module is stored in the OPSER 
package account OPSER$:, has a protection code of <232>, and requires SWCFG 
privilege to run. 

Td rim BATCH, type the following command while logged in to the system under 
an account with SWCFG privilege: 

$ RUN OPSER$:BATCH 

BATCH V10.0 RSTS VI0.0 TIMESHARING 

• 

Typically, this startup of BATCH is done in the system startup file. 

If you do not have the SWCFG privilege, the system displays an error message 
indicating that you do not have access to BATCH. 

If you have the SWCFG privilege, BATCH runs and prints its identification 
line and the number sign (#) prompt. In response to the # prompt, enter a 
specification in the following format: 

logical device:/startup switch(es) 

The logical device is the name of the queue and the unit number within that 
queue from which this copy of BATCH takes job requests. This name does not 
specify the static pseudokeyboard on which BATCH executes requests. The 
PHYSICAL startup option can specify the static pseudokeyboard unit on which 
BATCH executes. The logical name must have the form BA: or BAn: where n 
is a unit number from 0 to 7. If BAn: is specified, the Batch Processor executes 
requests queued to either that explicit unit or the general batch queue BA:. If 
BA: is specified, the program executes job requests in the batch queue regardless 
of the unit to which they are queued. 


NOTE 

The general batch spooling queue, BA:, is useful only on systems with 
Batch Processors running with the same default conditions. 

The logical device specified as the queue name must be a Batch Processor; the 
device name given must not have a logical assignment to some other device. 
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If only a queue name is given in response to the prompt and BATCH finds 
no errors, the program establishes default processing conditions, prints the 
DETACHING message, and detaches itself from the terminal. 

BATCH forms the default receiver identification from the queue name. BATCH 
also establishes other default conditions: 

• BATCH tolerates no errors and terminates any queued request encountering 
a fatal or warning error. 

• User log files are queued to the system default line printer with deletion 
specified. 

• The run burst remains unchanged. 

• The priority remains unchanged. 

At startup, BATCH performs the same error checking and processing SPOOL 
performs. See the section "Startup Error Processing" for the description of 
SPOOL startup error processing. 


A.5.1 BATCH Startup Options 

Include options with the BATCH processor designator to control its operation. 
Table A—14 summarizes these options, which are in the form of switches. 


Table A-14: BATCH Startup Options 


Option 

Syntax and Meaning 

ASSIGN 

/ASS[IGN] 

Reserves a pseudokeyboard device to this job. 

ERROR 

/ERR[OR] rseverity 

Sets the error severity default for this processor so that errors of 
that severity are tolerated and queued requests having that or lesser 
severity end successfully. 


/ERR[OR] :FAT[ AL] 

Tolerates all errors. 


/ERR[ORj:WAR[NING] 

Tolerates only warning errors. 


/ERR[0]R:N0N[E] 

Tolerates no errors (fatal and warning errors terminate queued re¬ 
quests). This is the default severity. 

DELETE 

/DELfETE] 

Deletes user log files after printing. This is the default condition unless 
the NODELETE option is specified. 

NAME 

/NAM[El:rcvrid 

Places, in the system message receiver table, the specified receiver 
identification for this job instead of the default identification. The 
default for a Batch Processor is BAnSPL for specific processors and 
BASPL for the general processor. 


(continued on next page) 
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Table A-14 (Cont.): BATCH Startup Options 


Option 

Syntax and Meaning 

NODELETE 

/NODEL[ETE] 

Does not delete user log files after printing. Without this option, all log 
files are deleted. Requester may override this option with the /NOQUE 
switch in the $JOB command. 

NOQUEUE 

/NOQUE[UE] 

Does not queue user log files for printing. Without this option, all 
log files are queued without a queue name and with deletion unless 
changed by the /QUEUE and /DELETE switches. Requesters cannot 
override this option. 

PHYSICAL 

/PHY[SICAL] :dev: 

Uses the pseudokeyboard (for example, PK1:) as the device on which 
this processor executes user batch jobs. 

PRIORITY 

/PRI[ORITY]:nnn 

Sets the job priority of BATCH to nnn, where nnn is a number from 
-120 to 120. Without this option, the priority remains unchanged. You 
need TUNE privilege to specify this qualifier. Do not use /PRIORITY 
after a /NAME, or /PHYSICAL switch, or after a BAn: designator. 

QUEUE 

/QUE[UE] :[quenam] 

Queues all user log files to the specified spooling queue (LPO: through 
LP7:) rather than to the general print queue. If no queue name is 
specified, all jobs are queued to the general print queue. Files are 
deleted after printing. Requesters may override queuing with the 
/NOQUE switch in the $JOB command. Deletion of the files by the 
SPOOL program may be overridden by including /NODELETE as a 
startup switch. 

RUNBURST 

/RUN[BURST]:nnn 

Sets the job run burst of BATCH to nnn, where nnn is a number from 

1 to 127. Without this option, the run burst remains unchanged. You 
need TUNE privilege to specify this qualifier. 


A.5.2 BATCH Interrupt Commands 

The operator uses interrupt commands sent through the operator services pro¬ 
gram OPSER to communicate with a Batch Processor. Note that any responses to 

an interrupt command are displayed on the Operator Services Console. 

Table A—15 summarizes these BATCH interrupt commands. 

Table A-15: BATCH Interrupt Commands 

Command Syntax Meaning 

ABO[RT] Immediately terminates the current process and removes the 

request from the queue. 

CON[TINUE] Wakes up the Batch Processor to continue normal processing af¬ 

ter either a PAUSE command or after a user request for operator 
action (for example, in the $MESSAGE/WAIT command). 


(continued on next page) 
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Table A-15 (Cont.): BATCH Interrupt Commands 


Command Syntax 

Meaning 

END 

Terminates processing after completing the current request. The 
operator must then run the Batch Processor again to process 
further requests. 

LAS[T] 

Prints the most recent message generated by this Batch 
Processor. 

NOT[ICE] text 

Inserts the specified text in the user log file and precedes it with 
the heading: NOTICE FROM OPERATOR. 

OFF[LINE] 

Immediately terminates all processing by this Batch Processor 
(same as ABORT followed by END). 

PAU[SE] 

Places the Batch Processor in a sleep state, during which it 
responds to most commands and resumes normal processing in 
response to a CONTINUE command. 

STAfTUS] 

Prints a status report for this Batch Processor. 


A.5.3 BATCH Startup Procedure 

BATCH is most conveniently started by commands in the system startup com¬ 
mand file. See the section "Creating and Using Command Files" in Chapter 3. 


A.5.4 Operator Action Requests from BATCH 

The BATCH program, in processing certain commands in a user command file, 
generates requests for operator action. These requests come through OPSER 
as action requests that require some operator action and a typed answer before 
the Batch Processor continues processing. These action requests result from 
commands requiring the operator either to mount and dismount volumes or to 
respond to a special message with which a stall is involved. The operator answers 
an action request with the ANSWER command through OPSER. 

On a mount request, BATCH asks the operator to mount a device by an action 
request with text in the following format: 

MOUNT xx:'logical id'/' vid'/WRITE/NOWRITE/DEN:nn/PAR:nn 
DEVICE? 

If a specific volume is involved, its identification appears as text replacing ‘vid.’ 
This text is the visual identification used to distinguish the volume. 
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Table A—16 lists the specific device type given by xx:. 


Table A-16: BATCH Device Type Designators 


Designator 

Meaning 

CD 

CD 11 punched card reader 

CR 

CR11 high speed punched card reader or the CM11 marked-sense 
card reader 

DB 

RP04, RP05 or RP06 disk pack drive 

DK 

RK05 or RK05F disk cartridge drive 

DM 

RK06/RK07 disk cartridge drive 

DL 

RL01/RL02 disk pack drive 

DR 

RM02/RM03/RM05/RM80 disk pack drive 

DT 

TU56 DECtape drive 

DU 

All MSCP disks: RA60, RA70, RA80, RA81, RA82, RA90, RD31, 
RD32, RD51, RD52, RD53, RD54, RC25, RX33, RX50 

DX 

RX01/RX02 floppy disk drive 

LP 

Any line printer 

MM 

TU16, TE16, TU45, or TU77 magnetic tape drive 

MS 

TS11, TSV05, TK25, or TU80 magnetic tape drive 

MT 

TM11, TU10, TE10, or TS03 magnetic tape drive 

MU 

TK50 or TU81 magnetic tape drive 

TT 

Any keyboard line 


If the text of the action request indicates a specific volume, the operator should 
mount the medium on a free unit of the device type specified by xx:. If a volume 
is not involved, the operator should make sure a unit of the type specified by xx: 
is ready and on line. 

When the unit is ready, the operator must type the device specification (device 
type and unit number followed by colon) as text in the ANSWER command for 
that action request number. BATCH assigns that unit and continues processing 
the user's queued request. 

When BATCH is done with the device, it generates an action request to dismount 
the volume or device. If the request involves a volume, the operator must remove 
the volume from the device specified and place the unit off line. To continue the 
BATCH processing, the operator types the CONTINUE command as text in the 
ANSWER command to OPSER for that action request number. This response 
tells BATCH to deassign the unit and to continue processing. 
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A.6 Operator Communication Program: PLEASE 

The PLEASE program communicates directly with the operator services program 
OPSER and, when OPSER is not running, sends text to the system console 
terminal (KBO:). The program PLEASE is stored in the OPSER package account 
OPSER$: with protection code of <232>. 

Any user can run PLEASE, but only users with SWCFG privilege or users defined 
as valid operators in the operator table can issue OPSER commands. 

You, as the system manager or assigned operator, can run PLEASE to send 
commands to OPSER. Users who do not have SWCFG privilege and are not valid 
operators may run PLEASE to send text to the Operator Services Console. 

NOTE 

If you want to restrict PLEASE to only be run by users with WREAD 
privilege, change its protection code to <124>. 


A.6.1 Running and Terminating PLEASE 

To run PLEASE, type the following command: 

$ RUN OPSER$:PLEASE 

PLEASE V10.0 RSTS V10.0 TIMESHARING 
# 

PLEASE prints its identification line and the number sign (#) character as a 
prompt to indicate it is ready to accept text. 

PLEASE accepts one line of text terminated with the Return key. A line of text 
exceeding the maximum length (255 characters) causes the program to print the 
error message ?Line too long and reprint the prompt. If the first character of 
text is not a slash (/) character, PLEASE tries to send the text as a message to 
OPSER. If the first character of text is a slash, PLEASE tries to send the text as 
a command to OPSER. To show the operator that it is sending the message or 
command, PLEASE prints one of the following messages: 

Message sent to 'OPSER' 

Command sent to 'OPSER' 

The program prints the # prompt again, after which the operator can type 
another line of text. Entering Ctrl/Z in response to the prompt terminates the 
program. 

When OPSER is not active, PLEASE broadcasts messages on the system console 
terminal; however, it does not send commands. In these situations, the program 
notifies the user with one of two messages: 

%OPSER not active - message broadcast to KBO: 

%OPSER not active - command not sent 

The message printed on keyboard unit 0 is preceded by the text: 

%MSG for 'OPSER' but it is not active: 
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A.6.2 OPSER Commands through PLEASE 


Any user with SWCFG privilege or defined as a valid operator can communicate 
with OPSER and with jobs on line to OPSER by typing a command through 
PLEASE. The user denotes an OPSER command by typing the slash (/) character 
as the first character in the line of text. 

Table A-17 summarizes these PLEASE commands to OPSER. Note that the 
circumflex ( A ) character marks the location of a required space. 


Table A-17: PLEASE Commands to OPSER 


Command Syntax 

Meaning 

/CHA A KBn: 

Changes operator services console to keyboard unit n. 

/DEL A msgnumber 

Deletes outstanding action request. 

/DEL A #nn:n 

Deletes n oldest action requests for job number #nn. 

/DET 

Detaches OPSER from the OSC. 

/EXI 

Terminates OPSER. 

[NO]FORM_FEED 

Enables or disables the printing of two form feeds at 
the beginning of each print job. 

[NO]FORMS_WAIT 

Enables or disables the "Forms waiting" message. 

/INT A rc vrid :text 

Sends unsolicited text to online job. 

/LIS A JO 

Prints online job table. 

/LIS A OP 

Prints valid operator table. 

/LOG A file;msglevel 

Creates log file and sets message level. 

/LOG A ;m8glevel 

Changes message level of current log file. 

/LOG 

Closes current log file and stops recording. 

/MES A msglevel 

Sets message level for OSC. 

/OPE A KBn:[nnn,nnn] 

Adds keyboard and account combination to valid 
operator table. 

/OPE A -KBn:[nnn,nnn] 

Removes keyboard and account combination from valid 
operator table. 

/RET A msgnumber 

Prints associated message. 

/RET A m:n 

Prints oldest m action requests for job number #n. 


When OPSER receives a command from PLEASE, it makes sure that the user has 
SWCFG privilege or that the user’s keyboard and account numbers are present 
in the valid operator table. If not, OPSER broadcasts the error message ?Invalid 
oper on the terminal from which the command was made. 

Commands sent by a valid operator can be executed by OPSER itself or by a 
program on line to OPSER. If OPSER itself executes the command, any response 
from the command is broadcast on the originating terminal. For example, because 
OPSER itself processes the LIST JOBS command, the online job list generated 
appears on the originating terminal. 

An INTERRUPT command, however, passes text to another program. Any 
response from the other program is displayed on the OSC and not on the 
originating terminal. To see a message or response from an INTERRUPT 
command, the operator should change the OSC to the current keyboard (the line 
on which PLEASE is running) before transmitting the command. Action requests 
and messages (responses to commands or text sent to OPSER) are displayed only 
if the current message level allows. 
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A.6.3 PLEASE as a CCL Command 

If you install PLEASE as a CCL command, the operator can type PLEASE 
followed by a text line to send commands to OPSER. PLE is the standard 
abbreviation for the CCL command. 


A.7 Terminating Operator Services and Spooling 

Usually you terminate OPSER and programs on line to OPSER by running the 
SHUTUP program. SHUTUP, however, terminates timesharing operations. If 
it is necessary to terminate operator services and spooling without shutting the 
system down, the operator can type a sequence of commands to stop spooling 
operations in an orderly fashion. To understand the sequence, you must know 
about OPSER shutdown levels. 


A.7.1 OPSER Shutdown Levels 

When OPSER receives a command from SHUTUP to perform an orderly shut¬ 
down in logical end mode, OPSER sends an END command to each online job in 
a fixed, logical sequence. OPSER selects by shutdown level the order in which 
jobs are ended. Online jobs at the lowest level terminate first. When all jobs 
at one level have terminated and have been removed from OPSER’S internal 
tables, OPSER begins sending END commands to jobs at the next highest level. 
When all online jobs have properly terminated, OPSER kills itself and SHUTUP 
proceeds with the system shutdown. 


A.7.2 OPSER Manual Shutdown Procedure 

You may need to shut down the SPOOL program without shutting down the 
entire system. The two possible procedures are as follows: 

• The operator can issue the END command to the spooler at any time. This 
command causes the spooler to shut itself down the next time it is ready to 
get a new job. Thus, if the spooler is printing a job, it completes the job’s 
output before shutting down. If SPOOL is waiting for a job, it shuts down 
immediately. The operator can use the ABORT command to terminate the job 
if the operator wants the job currently printing to end. 

For example, to manually shut down the LPOSPL spooler in logical end mode, 
use the command: 

PLE/INT LPOSPL:END 

At the completion of the current job, the spooler kills itself. This shutdown 
procedure merely mimics what OPSER does on command from SHUTUP. The 
operator sends the END command, in turn, to jobs at each shutdown level. 
The output of the LIST JOBS command gives the shutdown levels for each 
online job. When OPSER displays END messages for all jobs at one shutdown 
level, the operator can send the END command to all jobs at the next highest 
shutdown level. After the online job table is clear and OPSER has generated 
END messages for all jobs, the operator can send the EXIT command to 
OPSER. 
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• A second way of shutting down the spooler is with an OFFLINE command. 
The OFFLINE command immediately stops any job that is printing and 
prints an ABORT message on the listing to indicate the action taken. The 
OFFLINE command also causes SPOOL to shut down after the current job 
finishes. 

For example, to manually shut down the BAOSPL job immediately, use the 
command: 

PLE/INT BAOSPL:OFFLINE 

BAOSPL aborts the current job, clears it from QUEUE.SYS, and kills itself. 

If the operator wants to terminate a printing job for shutdown or any other 
reason, the line printer must be on line. Under no circumstances does the 
spooler consider a job completed until all the data that the spooler tries to print 
(including termination messages) is actually printed. If the operator aborts the 
job with the ABORT command, the spooler deletes (at the first opportunity) 
whatever data is already buffered; the line printer must be on line to allow this. 

If the operator wants no further output, use the REMOVE/JOB command to 
remove the spooler job. In this case, no clean-up can be performed. This process 
may be necessary when certain hardware fails (for example, if the line printer 
interface does not raise the READY flag). It should only be used in a crisis. 

The job that was being printed should be killed from the queue file by a QUE/K 
command from the operator. 


A.8 RESTOR as an OPSER Controlled Program 

The RESTOR program runs as a job on line to OPSER only after it has finally 
detached from its terminal. When RESTOR is running detached, the operator can 
send commands to it through OPSER. If, after having been detached, RESTOR is 
later attached to a terminal again, the operator can communicate with RESTOR 
either at its terminal or through the OPSER program. 
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Table A-18 summarizes the commands that RESTOR recognizes. Note that the 
circumflex ( A ) character marks the location of a required space. 

Table A-18: RESTOR Commands through OPSER 


Command Syntax 

Meaning 

ABO[RT] 

Terminates the RESTOR run immediately and removes 
RESTOR from OPSER internal tables. 

CON[TINUE] 

Wakes up the RESTOR program to continue processing after 
a PAUSE command or continues processing after an operator 
has performed some requested action. 

DET[ACH] 

Valid only under these conditions: 

END 

• If RESTOR is attached 

• OPSER is running 

• The RESTOR listing file is not on the terminal to which 
RESTOR is attached 

• No messages are currently pending for the specific 
RESTOR job 

If these conditions are met, RESTOR detaches and is given a 
receiver identification of BACKnn where nn is its job number. 
All further interaction with RESTOR is done through OPSER. 

Finishes transferring the current file and terminates process¬ 
ing. 

LAS[T] 

At the OSC, prints the most recent message generated by this 
RESTOR job. 

LEG[AL] 

At the OSC, prints a list of commands that can legally be given 
for this phase of the RESTOR run. 

NOT[ICE] A text 

Inserts the specified text in the RESTOR listing file. Precedes 
the text with the heading NOTICE FROM OPERATOR. 

PAU[SE] STA[TUS] 

Places RESTOR in a sleep state, during which it responds 
to most commands, continues normal processing in response 
to a CONTINUE command, and terminates processing on an 
ABORT command. Prints a status report for this RESTOR job. 


While RESTOR is running detached, it generates all of its requests for operator 
interaction through OPSER as messages. The operator uses the INTERRUPT 
command to respond to such requests. See the RSTS/E Utilities Reference 
Manual for the proper responses to RESTOR requests. 
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Appendix B 

Number Conversion 


Many applications require a number based on bit values in a PDP-11 word. 
Table B—1 lists the octal and decimal values for each bit in the PDP-11 word. 


Table B—1: Bit Values in the PDP-11 Word 


Bit Number 

Octal Value 

Decimal Value 

0 

1 

1 

1 

2 

2 

2 

4 

4 

3 

10 

8 

4 

20 

16 

5 

40 

32 

6 

100 

64 

7 

200 

128 

8 

400 

256 

9 

1000 

512 

10 

2000 

1024 

11 

4000 

2048 

12 

10000 

4096 

13 

20000 

8192 

14 

40000 

16384 

15 

100000 

32768 
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Appendix C 

Disk Device Sizes 


Table C—1 lists the device cluster size and device size (in 512-byte blocks) for each 
disk that RSTS/E supports. All values are in decimal. 
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Table C-1: Disk Device Sizes 


Disk 

Type 

Minimum 

Device 

Cluster Size 

Total Available Size 1 
(Blocks) 

RX50 

1 

800 

RX33 

1 

2400 

RK05 

1 

4800 

RK05F 

1 

4800 2 

RL01 

1 

10220 

RL02 

1 

20457 

RD51 

1 

21599 

RK06 

1 

27104 

RD31 

1 

41559 

RC25 

1 

50901 2 

RK07 

1 

53761 

RD52 

1 

60479 

RD32 

2 

83204 

RM02 

4 

131648 

RM03 

4 

131648 

RD53 

4 

138668 

RP04 

4 

171796 

RP05 

4 

171796 

RA80 

4 

237208 

RM80 

4 

242572 

RD54 

8 

311200 

RP06 

8 

340664 

RA60 

8 

400168 

RM05 

8 

500352 

RA70 

16 

507040 

RA81 

16 

891056 

RA82 

32 

1216640 

RA90 

64 

2376128 

'Size when disk is initialized at lowest acceptable cluster size 

2 For each unit; 2 units per drive 
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Appendix D 

General RSTS/E Messages 


This appendix lists many of the general messages that you may encounter when 
using RSTS/E. It is not a complete listing. Table D—1 also indicates the probable 
cause of the error in your use of a command or system program. 

If you perform DECnet/E operations, you may receive messages that are 
described in DECnet/E documentation but not in this appendix. In addition, the 
utility programs that support DCL can produce messages not all of which are 
listed here. Those messages are listed in the RSTS/E Utilities Reference Manual . 


D.1 Special Characters Used in Error Messages 

The question mark (?), double question mark (??), and percent sign (%) characters 
preceding a message indicate its severity. A single question mark precedes 
standard error messages, which means that the command failed to do what you 
asked but you can continue. For example: 

?Too many parameters 

In this case, the command failed because you included too many parameters. 

A double question mark precedes severe error messages, which means that the 
command failed to do what you asked and you cannot continue. For example: 

??Fatal system I/O failure 

By contrast, the percent sign identifies a warning message, which means that the 
command may not have worked as you intended. For example: 

%Logical name has not been assigned 

In this case, the MOUNT command worked but no logical name was assigned to 
the device. 

Informational messages do not have a preceding character; they provide extra 
details about the effects of a command. For example: 

Queue file being reorganized - please wait... 

This message informs you that, as a result of your command, the file is being 
reorganized. 

Angle brackets ( < > ) surrounding text indicate a place holder for what the 

system inserts when an error message occurs. 
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Table D-l lists the messages that you can get when using RSTS/E and the 
probable causes. 


Table D—1: General RSTS/E Messages 

Message and Meaning 

?Account or device in use 

The device cannot be mounted or dismounted because it is open or has 
one or more open files. This error can also occur when a user attempts 
to access a nonshared disk from a job other than the one specified in the 
/NOSHARE=n command. 

?Additional argument required 

You did not specify enough arguments in the DCL function. 

?Additional qualifier required 

You did not include a qualifier required in a command. 

%A11 volumes must be of the same media type 

You attempted to write a Backup set on both disk and tape. 

?Ambiguous keyword 

You abbreviated a keyword to short; DCL cannot distinguish it from other 
keywords. 

%An unrecognized character was typed - try again 

There were extra characters in the command line that BACKUP did not 
recognize as meaningful. 

?Argument not allowed 

You used an argument with a qualifier that does not accept one. 

?Argument required 

An argument was not supplied with a qualifier which required one. For 
example, /SINCE=, without an argument, would generate this error. 

The user did not supply an argument to a DCL function that required one. 

??Bad directory for device 

The directory of the device referenced is in an unreadable format. For 
example, the tape format differs from the format you specified with the 
MOUNT command. 

%Block header CRC error detected for block 

Although this block was read successfully by the source device, BACKUP 
discovered that there was an error in the block. BACKUP will attempt to 
recover the data using recovery data if possible. 

?Blocksize must be a multiple of <16 or 512> 

An invalid blocksize was specified. Blocksize must be a multiple of 16 for 
tape and 512 for disk. 

?Can’t access terminal<error text> 

An error occurred while attempting to access the terminal to send the setup 
file using the SET TERMINAL command. 

?Can’t find file or account 

Either the account or file does not exist, or you typed a file specification 
incorrectly. 


(continued on next page) 
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Table D-1 (Cont.): General RSTS/E Messages 


Message and Meaning 

?Can’t mount a private disk as public 

You tried to mount as public (using the MOUNT command’s /PUBLIC 
qualifier) a disk that was initialized as private. 

?Can’t rebuild disk because device is write protected 

A user with MOUNT privilege attempted to rebuild a disk (using the 
MOUNT command’s /REBUILD qualifier), and the drive is write protected. 
Therefore, the mount and rebuild operations fail. 

? Comm and not installed 

You typed a DCL command that has not been installed on your system. 

The DCL keyboard monitor could not find the utility needed to carry out 
your command. This message can also be displayed if you type a remote file 
specification in a command that allows remote file specifications, but your 
system does not have DECnet/E. 

?Command requires<privilege> privilege 

The user does not have the appropriate privileges to complete an operation. 

?Command too long 

The length of the command, including continuation lines, exceeds the 
maximum allowed for the command. Or, the length of the translated 
command string exceeds the maximum allowed for the command. For 
example, this message occurs with the LINK command in either of two 
cases: 

• The text you typed in response to the $ prompt and the Files: or Root 
files: prompt added up to more than 127 characters after translation. 

• With LINK/COBOL, the text was longer than 80 characters after 
translation. 

^Command will proceed as requested 

The user’s symbol tables could not be written out to the DCL work file, but 
the command will be processed. The user may be over quota. Corrective 
action should be taken before the user continues processing. 

?Comma required 

A DCL function required two or more arguments and they were not sepa¬ 
rated by a comma. 

?Conflicting arguments 

Multiple arguments to a qualifier conflict. For example, both an AFTER 
date and an exact date were specified to the /CREATED qualifier. 

?Conflicting elements 

You specified qualifiers or parameters in a command that do not agree in 
type (for example, a print qualifier with a batch server). 

?CPU limit exceeds queue’s maximum 

You specified a /CPU_LIMIT value in a SUBMIT command larger than the 
maximum allowed for the queue. 

?Data error on device 

One or more characters may have been transmitted incorrectly due to a 
parity error, bad punch combination on a card, or similar error. 


(continued on next page) 
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Table D-1 (Cont.): General RSTS/E Messages 


Message and Meaning 

?Data error or incorrect density 

This message occurs for one of the following reasons: 

• You specified the incorrect density. 

• The data on the tape is damaged. 

• The tape drive is faulty. 

?Default macro for KBn: does not exist 

The /INQUIRE command could not recognize the terminal and there was no 
default macro specified for this keyboard in the default file, TERDFL.SYS. 
You should supply a default macro for the keyboard. Until that is done, the 
keyboard's characteristics have to be set manually. 

Density of <density> BPI not available, using <density> BPI instead 

The requested density was not available on the drive. BACKUP reports the 
density that is being used. 

?Device does not exist 

The device name you specified does not exist on your system. 

%Device hung or write locked 
^Dismount will proceed as requested 

You attempted to dismount a disk that has been physically dismounted. 
However, the logical dismount will succeed. 

?Device hung or write locked 

Check the hardware condition of the device requested. Possible causes of 
this error include: 

• A line printer out of paper 

• A disk drive being off line 

• A DB or DR disk is dual-ported and is not write-protected 

%Device in use 

You specified /NOSHAREABLE in an INITIALIZE/SERVER command; 
however, the print server’s device is not available or no pseudokeyboards are 
currently available for the batch server. PBS allocates the device as soon as 
it becomes available. 

?Device is not a terminal 

A device other than a terminal was specified. Only specify keyboards. 

?Device is restricted 

This message occurs when a user without DEVICE privilege attempts to 
open files on a disk restricted to users with DEVICE privilege. 

?Device must be disk 

You specified a file on a nondisk device, where a disk device is required. 

?Device must be disk or tape 

The device specified was not a disk or tape, and only disk or tape is valid. 
?Device name may not be specified 

A device name is not valid at this point, but one was specified. 


(continued on next page) 
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Table D-1 (Cont.): General RSTS/E Messages 


Message and Meaning 

?Device not available 

The specified device exists on the system, but an attempt to allocate or use 
it is prohibited for one of the following reasons: 

• The device is currently reserved by another job. 

• The device requires privilege for ownership and you do have the 
necessary privilege. 

• The device or its controller has been disabled by the manager. 

• The device is a keyboard line for pseudo keyboard use only. 

?Device not file-structured 

An attempt was made to access a device, other than a disk drive or magnetic 
tape drive, as a file-structured device. 

?Device not write protected 

You specified the /NOWRITE qualifier when you tried to mount a magnetic 
tape, but the device is not write protected. Write protect the device by 
removing the plastic ring from the magnetic tape hub. 

?Device offline 

You tried to use a tape or disk, but the device is off line. 

%Device write protected 

The magnetic tape or disk is protected against write access. Therefore, you 
can only read files on the device, but cannot write (perform output) to the 
device. If you want to write to the device, first write enable the device, next 
dismount the device, and then mount the device again. 

?Device write protected 

You requested write access to a device that is write protected. Write enable 
the device and then retype the command. 

^Directory attributes verification failure for directory <directory> 

The directory attributes stored in the Backup set are different from the di¬ 
rectory attributes as stored in the directory structure. This is a verification 
mismatch. This can happen if a user logs in or out during a backup. 

?Directory does not exist 

A file specification indicates a directory that does not exist on the particular 
private disk. Or, a wildcard directory specification failed to produce a match 
on the disk specified. This error can occur only with private disks. 

??Disk error during swap 

A hardware error occurs when your job is swapped into or out of memory. 
The contents of the job area are lost, but the job remains logged in to the 
system and returns to DCL. Report such occurrences to the system manager. 

Disk is being rebuilt - wait... 

This informational message is displayed when a user attempts to rebuild 
a disk. The disk is logically mounted when the rebuilding operation is 
complete. 

?Disk is mounted nonshared 

A user attempted to dismount a disk that was mounted as nonshared (by a 
different job) by specifying /PUBLIC in the DISMOUNT command. 

(continued on next page) 
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Table D-1 (Cont.): General RSTS/E Messages 


Message and Meaning 

?Disk is mounted private or nonshared 

A user attempted to dismount a disk that was mounted as nonshared (by the 
same job) or private by specifying /PUBLIC in the DISMOUNT command. 

?Disk is mounted public 

A user with MOUNT privilege attempted to dismount a public disk that 
was mounted as public, without specifying /PUBLIC in the DISMOUNT 
command, so the dismount fails. 

%Disk is mounted read-only 

This warning occurs if you do not specify either read or write access 
(/NOWRITE or /WRITE) when mounting a disk initialized as read-only. 
Therefore, you are granted read access only. 

?Disk is NOSHARE to another job; can’t verify pack-id 

A user with MOUNT privilege attempted to mount a disk that is mounted 
/NOSHARE to another job. 

%Disk is restricted and mounted nonshared, read-only 

A user specified /NOREBUILD (to suppress rebuilding) and /NOSHARE 
in the MOUNT command and the disk was dirty. Therefore, the disk 
is mounted nonshared and restricted, and read-only access is granted. 

( Restricted means that access is allowed only to users with DEVICE 
privilege.) 

%Disk is restricted and mounted private, read-only 

A user specified /NOREBUILD (to suppress rebuilding) and /SHARE in the 
MOUNT command and the disk was dirty. Therefore, the disk is mounted 
nonshared and restricted, and read-only access is granted. ('"Restricted" 
means that access is allowed only to users with DEVICE privilege.) 

?Disk needs rebuilding but device is write protected 

A user with MOUNT privilege attempted to mount a dirty disk (and did not 
specify /REBUILD or /NOREBUILD), but the device is write protected and 
the automatic rebuilding cannot be performed. Therefore, the mount fails. 

?Disk needs rebuilding but you do not have MOUNT privilege 

This message occurs when a user without MOUNT privilege tries to mount 
a private disk that was not logically dismounted. The system manager can 
correct the situation by rebuilding the disk. 

?Disk needs rebuilding, so it can not be NORESTRICT 

This message occurs when a user with MOUNT privilege tries to mount a 
dirty disk with both /NOREBUILD and /NORESTRICT qualifiers. 

?Disk pack is not mounted 

The DISMOUNT command was attempted, but the disk pack was not 
mounted on the specified disk drive. 

??Disk pack mount error 

Fatal disk mounting error. The disk is corrupt and cannot be successfully 
mounted with the MOUNT command. 

?Disk too small to be RSTS file-structured 

Attempted to initialize a virtual disk smaller than 16 blocks. 


(continued on next page) 
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Table D-1 (Cont.): General RSTS/E Messages 


Message and Meaning 

?Dismount will proceed as requested 

The disk was physically dismounted before the logical dismount was fin¬ 
ished. RSTS/E will flag the device as dismounted anyway. 

?Division by zero 

The expression specified by the user attempted to divide by zero. 

?Do not specify file name or type 

This message can occur with the first parameter of the ASSIGN command. 
Remember to use a space between the first parameter (the string you assign) 
and the second parameter (the name you assign it). For example, ’ASSIGN 
DR3: X”, not ’’ASSIGN DR3X ". 

%Dual-ported disk, may still be mounted on another system 

You specified a DB or DR disk in a DISMOUNT command that is dual- 
ported. So, it may still be mounted on another system. 

?Equal sign required 

You used a qualifier that requires an argument, but you did not give an 
argument. 

?Error assigning Backup set device 

The RSTS/E monitor reported an error in response to BACKUP’S request 
to assign the Backup set device. This message will be followed by another 
message describing the problem. 

?Error closing Backup set 

The RSTS/E monitor reported an error in response to BACKUP’S request to 
close the Backup set. A message detailing the problem will follow. 

?Error creating directory<directory> 

The RSTS/E monitor reported an error in response to BACKUFs request to 
create a directory. A message detailing the problem will follow. 

?Error creating disk initialization command file 

The RSTS/E monitor reported an error in response to BACKUP’S request 
to create the command file used to initialize disks. A message detailing the 
problem will follow. 

?Error creating dynamic region 

The RSTS/E monitor reported an error in response to BACKUFs request to 
create a dynamic region. A message detailing the problem will follow. 

?Error creating job to initialize disk 

The RSTS/E monitor reported an error in response to BACKUP’S request to 
create a job, used to initialize disks. A message detailing the problem will 
follow. 

?Error creating output directory 

The RSTS/E monitor reported an error in response to BACKUP’S request to 
create a directory. A message detailing the problem will follow. 

?Error deassigning Backup set device 

The RSTS/E monitor reported an error in response to BACKUP’S request to 
deassign the Backup set device. A message detailing the problem will follow. 


(continued on next page) 
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Table D-1 (Cont.): General RSTS/E Messages 


Message and Meaning 


?Error dismounting disk to initialize it 

The RSTS/E monitor reported an error in response to BACKUPS request 
to dismount a disk so that it can be reinitialized. A message detailing the 
problem will follow. 

?Error in forms definition<forms-name> 

<error message> 

An error, as the error message in the second line describes, was discovered 
in the forms definition displayed. 

?Error initializing Backup set 

The RSTS/E monitor reported an error in response to BACKUFs request to 
initialize the Backup set. This message will be followed by another message 
detailing the problem. 

?Error mounting output disk 

This message indicates that the monitor has reported an error as a result 
of BACKUPS mount request. It will be followed by an error detailing the 
problem. 

?Error mounting Backup set 

The RSTS/E monitor reported an error in response to BACKUFs request to 
mount the Backup set. A message detailing the problem will follow. 

?Error number nn 

An I/O error occurred while the system was attempting to retrieve an error 
message. Possible causes could be that the device containing the system 
error file (ERR.SYS) is offline, or that the system error file contains a bad 
block. 

This is a serious error, and should be reported to the system manager. 

?Error obtaining file flags for file <filename> for verification 

The RSTS/E monitor reported an error when BACKUP requested to find 
out what the file flags for a file to verify were set to. This message will be 
followed by another message describing the problem. 

?Error opening disk nonfilestructured to initialize it 
<error message> 

This message occurs when BACKUP is requested to initialize a disk and 
the RSTS/E monitor is unable to open it in nonfilestructured mode. This 
generally happens because a disk unit is off line or no disk is mounted 
in the drive. This can also occur for other reasons, such as no access to 
nonfilestructured disks or other device specific errors. 

?Error opening file <filename> for input - skipping rest of directory 

The RSTS/E monitor reported an error in response to BACKUFs request 
to open a file in the directory (note that since the filename is unknown at 
the time, this may contain wildcards). A message detailing the problem 
will follow. Since BACKUP scans the directory sequentially, the rest of the 
directory will be skipped. 

?Error opening file <filename> for output 

The monitor reported an error to BACKUP when it was trying to create a 
file. This message will be followed by a message describing the problem. 


(continued on next page) 
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Table D-1 (Cont.): General RSTS/E Messages 


Message and Meaning 

?Error opening file <filename> for verification 

The RSTS/E monitor reported an error in response to BACKUP’S request 
to open a file for verification. This message will be followed by another 
message detailing the problem. 

?Error opening PBS file <file-spec> 

<error message> 

An error, as the error message in the second line describes, occurred opening 
the PBS file indicated. 

?Error opening Backup set 

The RSTS/E monitor reported an error in response to BACKUP’S request to 
open the Backup set. Another message will follow, describing the problem. 

?Error opening Backup set nonfile structured 

The RSTS/E monitor reported an error in response to BACKUP’S request to 
open the Backup set device for control purposes. An error follows which will 
detail the problem. 

?Error performing PPN lookup 

The RSTS/E monitor reported an error in response to BACKUPS request to 
look up PPNs to back up. A message detailing the problem will follow. 

?Error reading accounting data for directory <directory> 

The RSTS/E monitor reported an error in response to BACKUPs request to 
read the accounting data for a directory. A message detailing the problem 
will follow. 

?Error reading directory attributes for directory <directory> 

The RSTS/E monitor reported an error in response to BACKUPs request to 
read directory attributes. A message detailing the problem will follow. 

?Error reading file attributes for file <filename> 

The RSTS/E monitor reported an error in response to BACKUPs request 
to read file attributes for a file being backed up. A message detailing the 
problem will follow. 

?Error reading file <filename> block <block> 

The RSTS/E monitor reported an error in response to BACKUPs request to 
read file data. A message detailing the problem will follow. 

?Error reading output volume label 

The monitor reported an error to BACKUP in response to a request to 
determine the volume label of the output device. This message will be 
followed by a message detailing the problem. 

?Error reading Backup set 

This message indicates that an error was reported by the monitor to 
BACKUP when attempting to read the Backup set. It will be followed by a 
device specific error message describing the problem. In addition, it may be 
followed by other messages if BACKUP is unable to recover from the lost 
data. 


(continued on next page) 
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Table D-1 (Cont.): General RSTS/E Messages 


Message and Meaning 

?Error reading Backup set attributes 

The RSTS/E monitor reported an error in response to BACKUPS request 
to read the Backup set attributes. An error follows which will detail the 
problem. 

?Error reading Backup set volume label 

The RSTS/E monitor reported an error in response to BACKUPS request to 
read the Backup set label. A message detailing the problem follows. 

?Error restoring file dates for file <filename> 

The RSTS/E monitor reported an error in response to BACKUP’S attempt 
to restore file dates. Another message describing the problem follows this 
message. 

?Error rewinding Backup set 

BACKUP encountered an error when asking the monitor to rewind the 
Backup set. A message detailing the problem follows. 

?Error setting end-of-volume flag 

The RSTS/E monitor reported an error in response to BACKUPS request to 
set the end-of-volume flag. A message detailing the problem follows. 

?Error setting file flags for file <filename> 

The RSTS/E monitor reported an error in response to BACKUP’S attempt 
to set file flags (caching, protected, etc.). Another message describing the 
problem follows this message. 

?Error setting RTS name for file <filename> 

The RSTS/E monitor reported an error in response to BACKUP’S attempt 
to set the runtime system name for a file. Another message describing the 
problem follows this message. 

<error text> opening setup file <filename> 

An error occurred while trying to gain access to the setup file. 

<error text> opening speed file 

An error occurred while trying to gain access to the speed file. The speed is 
not set and the rest of the SET TERMINAL command is executed. 

<error text> opening/reading default file 

An error occurred while processing the default file. 

<error text> reading setup file <filename> 

An error occurred while processing the setup file. 

<error text> reading speed file 

An error occurred while processing the speed file. The speed is not set and 
the rest of the SET TERMINAL command is executed. 

?Error verifying directory attributes for directory <directory> 

The RSTS/E monitor reported an error in response to BACKUPS request to 
read directory attributes for verification. Another message describing the 
problem follows this message. 
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?Error verifying directory <directory> 

The RSTS/E monitor reported an error in response to BACKUPS request to 
obtain directory information for verification. Another message describing 
the problem follows this message. 

?Error writing directory attributes for directory <directory> 

The RSTS/E monitor reported an error in response to BACKUPS request to 
write directory attributes. Another message describing the problem follows 
this message. 

?Error writing file attributes for file <filename> 

The monitor reported an error to BACKUP when it was trying to restore file 
attributes. Another message describing the problem follows this message. 

?Error writing Backup set 

The RSTS/E monitor reported an error in response to BACKUP’S request to 
write to the Backup set. Another message describing the problem follows 
this message. 

?Error writing Backup set attributes 

The RSTS/E monitor reported an error in response to BACKUPS request to 
write the Backup set attributes. Another message describing the problem 
follows this message. 

?Error writing to disk initialization command file 

The RSTS/E monitor reported an error in response to BACKUP’S request 
to write to the command file used to initialize disks. Another message 
describing the problem follows this message. 

?Error writing to list file 

The RSTS/E monitor reported an error in response to BACKUPs request to 
write to the list file. Another message describing the problem follows this 
message. 

?Extra file data found in file <filename> - ignoring it 

RESTORE found file data blocks for blocks beyond the written end of 
file. If this happened with a SAVE set produced by RSTS/E and was not 
accompanied by other messages, submit a SPR with a copy of the Backup 
set. 

??Fatal system I/O failure 

An I/O error has occurred on the system level. The results of the last 
command are unpredictable. This error is caused by a hardware condition. 
Report such occurrences to your system manager. 

?File attributes for file <filename> may be incorrect 

If BACKUP has used recovery data to restore a file, there is a chance that 
the file attributes may not be correct. If this is a possibility, BACKUP 
informs the user with this message. 

?File data block for file <filename> duplicated in Backup set 

RESTORE found a file block duplicated in the Backup set. If this this 
happened with a SAVE set produced by RSTS/E and was not accompanied 
by other errors, submit a SPR containing a copy of the Backup set. 
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?File data block for file <filename> missing in Backup set 

RESTORE found a file block missing in the Backup set. If this was not 
accompanied by other errors, submit a SPR containing a copy of the Backup 
set. 

?File data in file may be incorrect 

This message can occur if there are several missing blocks from a Backup 
set. It should be accompanied by other messages, describing the cause of 
the problem. If not, submit a SPR with a copy of the Backup set. 

?File does not exist 

This message occurs for one of the following reasons: 

• An input file that must be present is not present. 

• A wildcard file specification does not match any files. 

• A file is not accessible because of its assigned protection code. 

File <filename> not replaced 

This is an informational message, which reports that a file was not restored 
because there was a file of the same name already existing and you did not 
use the /REPLACE qualifier. 

File <filename> restored as noncontiguous 

The RSTS/E monitor was unable to locate contiguous space to restore a 
contiguous file as contiguous. 

?File name attribute invalid - skipping file 

If this Backup set was written by RSTS/E BACKUP, submit a SPR contain¬ 
ing a copy of the Backup set. If this Backup set was written by any other 
operating system, it indicates that the file name could not be mapped into 
a RSTS/E name, and was skipped. Rename the file on the source system to 
something which will fit into the RSTS/E file naming scheme. 

?File name attribute missing - skipping file 

Submit a SPR with a copy of the Backup set. 

?File name required 

A file specification you typed does not include a file name, but one is needed. 

?File specification required 

This error occurs if you specify node:: without a file specification (ex¬ 
cept with DIRECTORY). It also occurs if you have two commas with no 
characters between them in a file specification list. 

?Files cannot be on different nodes 

This message occurs with network operations. Each input file specification 
you include in a network command must be on the same node. 

?Form <form-name> does not exist 

The form name you specified was not defined by the system manager. See 
your system manager to find out what form names are available. 

?Forms Definition File does not exist 

The forms definition file, PBS$:FORMS.SYS does not exist. See your system 
manager. 
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?Forms not defined [for server <server-name>] 

The forms you specified could not be found in the forms definition file. See 
your system manager. 

%ID label ignored 

You mounted a tape in DOS format and specified an ID label. Identification 
labels are not encoded on DOS tapes; therefore, the label you specified is not 
recognized by the MOUNT command. 

%ID label should be specified when you mount an ANSI tape 

You mounted a tape in ANSI format, but did not specify the tape identifi¬ 
cation label. Digital recommends that you specify the identification label. 
Thus, the MOUNT command can verify that the tape you selected has been 
mounted. 

?ID labels don’t match 

The identification label you specified does not match the identification 
label encoded on the tape. To correct the problem, specify the correct 
identification label. If you do not know what identification label is encoded 
on the tape, you can omit the ID label from the MOUNT command. 

?Illegal byte count for I/O 

The range of memory starting at the load address given is not avail¬ 
able. Refer to the memory status report of a display program (SYSTAT or 
DISPLY) to select an available range of memory. Note that you can also use 
the SHOW MEMORY command. 

?Illegal filename 

The file name given in the command contains characters other than alpha¬ 
betic or numeric characters. 

?Illegal switch usage 

A CCL command contains an error in an otherwise valid CCL switch 
(qualifier). For example, you cannot use the /SI:n switch without a value for 
n or a colon; or you cannot specify more than one of the same type of CCL 
switch. 

?Illegal value - n 

The swap file number specified is not 0, 1, or 3. (The swap file 2 already 
exists on the system disk and can not be added.) 

?Impossible density for this device 

You tried to mount or initialize a tape, but specified a density not available 
on the tape drive you used. To correct the problem, use another drive or 
specify a different density. 

?Incorrect density 

You specified a density different from the tape’s density. 
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?Incorrect density or uninitialized tape 

This message can occur for the following reasons: 

• You tried to mount a tape that had not been initialized. 

• You specified an incorrect density. If the tape has not been initialized, 
use the INITIALIZE command. Otherwise, specify the correct density. 

If the tape has not been initialized, use the INITIALIZE command. 
Otherwise, specify the correct density. 

?Invalid account 

The account specified was not valid either containing invalid characters (for 
example, [ AAA ]) or an invalid format (for example, [1,2345]). 

?Invalid argument 

This error can occur when you use a qualifier in the form/qualifier=argument. 
The qualifier you used is spelled properly, and the equal sign (=) or colon (:) 
is present; however, the argument is either missing or syntactically invalid. 

RSTS/E displays this error message when there is no more specific message 
to describe the syntax error. 

?Invalid at interactive level 

You specified a command that is invalid at the interactive level. (For 
example, GOTO LABEL). 

?Invalid attribute length - attribute skipped 

If you get this message, submit an SPR with a copy of the Backup set that 
generated the error. 

?Invalid attribute - attribute skipped 

This message indicates that the version number of a record was higher than 
the highest version known to BACKUP. If this error occurs trying to restore 
a Backup set written by a newer version of BACKUP on an older version of 
BACKUP, the operation may not work properly. If the version of BACKUP 
writing the tape is older or the same as the one doing the RESTORE, submit 
an SPR with a copy of the Backup set that generated the error. 

?Invalid BATCH command 

Although the command is valid in interactive mode, the command is not a 
valid BATCH command because it implies or requires interaction with the 
user. (For example, INQUIRE, SET NODATA). 

?Invalid CCL command 

You used the CCL prefix followed by a command that is not installed as a 
CCL command on your system. 

?Invalid channel number 

The I/O channel number specified was invalid. Channel numbers can range 
from 1 to 13 on OPEN, READ and CLOSE commands, and from 0 to 13 on 
WRITE commands. 

?Invalid character 

You typed an invalid punctuation character. 
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?Invalid command 

The command name you gave is not a DCL command, and is not defined 
on your system as a CCL command. Or, the line begins with a punctuation 
character rather than with a keyword. 

?Invalid date 

A date either has improper syntax, represents a nonexistent date (for 
example, 30-Feb), or represents a date before 1970 or after 1999. 

?Invalid density - n 

You tried to mount or initialize a tape, but specified a density other than 
800 or 1600 bpi. The n is the density you specified. 

?Invalid device 

The device specified could not be found in the list of standard devices or in 
the user-defined macros (TERMAC.SYS). Specify a valid device. 

%Invalid directory attribute record - skipping 

This message indicates that a directory attribute code found in a Backup set 
was unknown to BACKUP. If this error occurs trying to restore a Backup 
set written by a newer version of BACKUP on an older version of BACKUP, 
the operation may not work properly. If the version of BACKUP writing the 
tape is older or the same as the one doing the RESTORE, submit an SPR 
with a copy of the Backup set that generated the error. 

?Invalid entry name 

The entry name you specified is invalid. 

?Invalid expression 

This covers a range of expression problems. The most common of these is an 
expression ending in an operator without supplying a second operand (for 
example, A = B *). 

?Invalid file specification 

A local file specification has improper syntax. 

?Invalid fill factor 

A fill factor was specified that was less than 0 or greater than 6. 

?Invalid form definition 

The definition of the specified form contains an invalid keyword or keyword 
argument. 

?Invalid form name 

The form name you specified is either longer than six characters or consists 
of one or more nonalphanumeric characters. 

?Invalid function 

The function name specified after F$ is invalid. The minimum abbreviation 
point is not met for the function (for example, F$LE is not valid because of 
F$LEFT and F$LEN). 
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%Invalid keyboard numbers n , n in default file 

The numbers you specified in the default file were less than 0, greater than 
127, or the first number of the range is greater than the second number of 
the range. 

^Invalid keyboard numbers n , n in speed file 

The numbers you specified in the speed file were less than 0, greater than 
127, or the first number of the range is greater than the second number of 
the range. 

?Invalid keyword 

The keyword is not recognized. This error occurs with keywords that are 
not qualifiers and are not command names. (For example, it can occur with 
the options of SET and SHOW, and with qualifier values that are keywords.) 

?Invalid label 

The label specified in the command procedure contains invalid characters. 

?Invalid node name 

The node name field of the file specification contained invalid characters. 

?Invalid operation on system disk 

You specified an operation on the system disk which is invalid (for example 
DISMOUNT). 

?lnvalid operator 

The operator you specified in the expression is not a defined logical, arith¬ 
metic, string, arithmetic comparison or string comparison operator. 

?Invalid PPN 

The project-programmer number (PPN) you specified does not have valid 
syntax. 

?lnvalid print device 

The device you specified is not a valid print device because it is not a line 
printer or terminal. 

?Invalid private delimiter 

The delimiter you specified was not in one of the correct formats. 

?Invalid qualifier 

The qualifier keyword is not valid in the command you typed. (This message 
may indicate an error in spelling or typing.) 

?Invalid qualifier for disk 

This message occurs when you specify an invalid qualifier for disks. For 
example, /FORMAT=ANSI (applies only to magnetic tapes). 

?Invalid qualifier for tape 

This message occurs when you specify an invalid qualifier for tapes. For 
example, /PRIVATE (applies only to disks). 

?Invalid queue name 

The queue name you specified is invalid. 
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?Invalid record length in Backup set - record skipped 

If you get this message, submit an SPR with a copy of the Backup set that 
generated the error. 

%Invalid Backup set attributes - can’t use it 

The Backup set does not have the attributes correct for a BACKUP Backup 
set. 

?Invalid server name 

The server name you specified is invalid. 

?Invalid speed 

The speed specified was not a valid speed for the interface of the terminal. 
Only specify speeds that the interface supports. 

?Invalid symbol name 

You specified a symbol name that contains invalid characters. 

?Invalid time 

A time either has improper syntax or represents a nonexistent time (like 
25:00 or 13:00PM). 

?Invalid width 

You specified a width that was less than 1 or greater than 254. 

?Invalid with network file specification 

You gave a network file specification in one of the commands that accepts 
them (RENAME, COPY, and so on), but you also gave a qualifier that can be 
used only with local operations. 

71/0 to detached keyboard 

This message can result from one of two actions: 

• You tried to perform I/O with a terminal line that is used for dial-up 
terminals, but nobody was dialed in. 

• Your job became detached (perhaps because you were dialed in and your 
line was later hung up) and then tried to perform I/O with the terminal. 

The second situation either causes the job to hibernate or causes this error 
condition, after which the job hibernates. You see this message when you 
subsequently attach to the job. 

?Keyword required 

You typed nonalphanumeric characters when a keyword is needed instead. 
(If you type alphanumeric characters without a valid keyword, you receive 
the error message, ?Invalid keyword.) 

?Label already defined 

A label was defined more than once in an indirect command procedure. 

?Label too long 

The label you specified in the indirect command procedure was longer than 
255 characters. 

?Log file already open 

A log file was already currently open when you attempted to open another 
log file using the OPEN/LOG_FILE command. 
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?Log file not currently open 

You attempted to enable or disable logging using the SET LOG_FILE 
command, and a log file did not exist. 

?Log file print queue closed 

The print queue required for a SUBMIT command’s /LOG_QUEUE qualifier 
is closed or marked for deletion. Use a different print queue for the log file. 

?Log file print queue does not exist 

The print queue you specified with the /LOG_QUEUE qualifier in a SUBMIT 
command does not exist. Specify a different queue. 

%Logical name has not been assigned 

This warning can be displayed for one of two reasons: 

• You had INSTAL privilege and specified a logical name that was not 
assigned as a system logical. (This means that neither the alternate 
logical name nor the pack-id label were assigned.) 

• You did not have INSTAL privilege and specified an alternate logical 
name when attempting to mount a disk. 

The mount succeeds in both cases, but the logical name is not assigned. 
?Logins are disabled—please try again later 

This message can be displayed when you try to log in, for one of two reasons: 

• The system is full, so it cannot accept additional users. 

• The system manager has disabled logins. 

(Possibly, logins are disabled because the system will be shut down shortly.) 

?Magtape record length error 

When performing input from magnetic tape, the record on tape was found to 
be longer than the buffer designated to handle the record. 

?Magtape select error 

When access to a magnetic tape drive was attempted, the selected unit was 
found to be off line. This error can occur when you transfer data to or from 
a tape. 

?Map or executable file required 

With LINK, you specified /NOEXECUTABLE and did not specify a map file. 

??Maximum memory exceeded 

This is a nonrecoverable RSTS/E error caused by the following conditions: 

• While loading a program into memory, the job’s private maximum 
memory size was reached. 

• While executing a program, the system required more memory for string 
or I/O buffer space, and the job’s private maximum memory size or the 
system maximum was reached. 
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?Missing closing apostrophe 

The user did not specify matching apostrophes (’... ’) when requesting 
apostrophe substitution. 

?Missing closing bracket 

This error can occur in a local or remote file specification. There is a left 
bracket ([) or left angle bracket (<), but no right bracket (]) or right angle 
bracket (>). 

?Missing closing quote 

A quotation mark (") is not matched with another quotation mark. (This 
error can occur in remote file specifications.) 

?Missing device or file name 

The command must contain either a device specification or a device and file 
name specification. If you use the /SI:n switch, a file name must be present. 

?Missing open parenthesis 

You did not specify an open parenthesis [(] when one was expected. 

%More than 16 speeds specified for <terminal> 

While processing the TERSPD.SYS file, a terminal was found that had more 
than 16 speeds specified. Only the first 16 speeds are used. 

7MOUNT privilege is required 

You attempted an operation that requires MOUNT privilege. For example, a 
user without MOUNT privilege can mount only private disks. 

7MOUNT privilege required to dismount a public disk 

A user without MOUNT privilege tried to dismount a disk initialized as 
public. A user without MOUNT privilege can dismount only private disks. 

7MOUNT privilege required to rebuild a disk 

This message occurs when a user without MOUNT privilege attempts 
to rebuild a private disk with the /REBUILD qualifier of the MOUNT 
command. Have your system manager rebuild the disk. 

?Name or account now exists 

You attempted either to COPY to or RENAME an existing file. This error 
can occur with RENAME if you do not specify /REPLACE and the output 
file already exists. It can also occur with COPY if you specify /NOREPLACE 
and the output file already exists. 

7Network node names must be the same 

Different node names were specified on input file specifications. 

7No buffer space available 

The system is overloaded and cannot complete your command because small 
buffers are currently unavailable. Try the command again later. 

?No channels available 

An I/O or DCL command file channel is not available. You may have issued 
the at (@) command or an F$SEARCH or OPEN command, but a channel is 
not available. 
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?No default |Print,Batch| queue 

You did not specify a queue name with the PRINT or SUBMIT command, 
and no default queue exists. 

?No default print queue for log file 

The /LOG_QUEUE qualifier in a SUBMIT command was specified without 
an explicit queue name; however, no default print queue exists. Use an 
explicit queue name for the log file. 

?No file name or type permitted 

A device:ppn syntax was expected and you supplied a full file specification 
which included either a file name or type. 

?Nonexecutable file 

This error occurs if the file you are trying to run is a source file; for example, 
.BAS. You need to compile and link the file before you run it. (Note that an 
executable file includes the value 64 in its protection code.) 

?Nonprintable character 

You typed a control character. 

??Nonres run-time system 

This message generally indicates hardware problems. For example, the 
run-time system referenced has not been loaded into memory and cannot be 
loaded for some reason, and is therefore nonresident. 

%No owner rights to (print,batch} entry <entry-spec> 

The entry shown is not your own and you do not have sufficient privilege to 
delete it or modify it. 

?NO prefix not allowed 

You used the /NO prefix improperly. 

%No (Print,Batch} entry <entry-spec> found 

No entries matching the entry-spec you specified in a SHOW ENTRY or SET 
ENTRY command were found. 

%No (Print,Batch} queue <queue-name> found 

No queues matching the queue name you specified in a SHOW QUEUE or 
SET QUEUE command were found. 

%No (Print,Batch} server <server-name> found 

No servers matching the server name you specified in a SHOW SERVER or 
SET SERVER command were found. 

?No qualifiers allowed 

The user specified a qualifier on a command that does not allow qualifiers. 

%No qualifiers are valid for RESTORE 

You attempted to enter a qualifier to the RESTORE mount qualifier. No 
qualifiers are valid. 

?No (read,write,or read/write} access to file <file-spec> [by owner] 

The file specifications in a PRINT or SUBMIT command requires access that 
you or the specified owner does not have. 
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?No room for user on device 

In attempting to create a file on a device, or write information to a device, 
you exceeded some size limit. If it was a nondisk device, this error indicates 
that the device was full. If it was a disk device, this error indicates one of 
three conditions: 

• The disk as a whole is full. 

• You attempted to create a contiguous file, and there is not enough space 
on the disk. (However, the /CONTIGUOUS qualifier for the commands 
COPY and CREATE produce only a warning if there is not enough 
contiguous space.) 

If you attempted to create a contiguous file but were unable to, try to 
create a noncontiguous file of the same size. If you are able to create 
a noncontiguous file then you can conclude the problem is lack of 
contiguous space. 

• If you have eliminated the first two conditions, then the disk directory 
has reached its capacity. This capacity is independent of your disk 
quota. The number varies, depending on the directory cluster size that 
the system manager assigned when creating the directory and the sizes 
of the files in it. Large files fill up a directory faster than small files, 
especially if the files have small cluster sizes. Also, if the directory itself 
has a large cluster size, it can hold more files and larger files. 

?No run-time system 

This error can occur if the program you are trying to run requires a run-time 
system that is not installed. 

?Not a valid device 

The device name that you gave is invalid for any of the following reasons: 

• It is not assigned as a systemwide or user logical name. 

• It is not a physical device name of any device that is installed on your 
system. 

• The device name is valid, but not with this command. For example, 
’’INITIALIZE TT:" (you cannot initialize a terminal). 

?Not enough available memory 

An attempt was made to load a executable program that is too large to 
run, given the job's private maximum memory size. Either the program 
must be allowed to expand above a private maximum memory size, or the 
system manager must increase the job's private memoiy size maximum to 
accommodate the program. 

?Not enough free memory to create dynamic region 

There is not enough memory on the system to create a dynamic region 
of sufficient size for the operation. If this is a BACKUP, reducing the 
BLOCKSIZE or BUFFERSIZE parameters, or both, may correct the prob¬ 
lem. 

?Number not in range <low> or <high> 

You typed a number where one is allowed, but the number is not in the valid 
range. The valid range is from <low> to <high>. 
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?Number too big 

You typed a number where one is allowed, but the number is too large. 
Refer to the command description to find out the largest acceptable value. 

?Number too small 

You typed a number where one is allowed, but the number is too small. 
Refer to the command description to find out the smallest acceptable value. 

?Pack-id labels don’t matcb 

The identification code for the specified disk pack does not match the 
identification code already on the pack. This message can occur when you 
try to mount or dismount a disk. 

limit exceeds queue’s maximum 

You specified a /PAGE.LIMIT value in a PRINT command larger than the 
maximum allowed for the queue. 

?Parameter or argument too long 

This message occurs if a file specification, text string, or qualifier argument 
exceeds 255 characters. 

%Please answer "YES" or "NO" 

Valid responses to the given prompt are YES and NO only. 

%Please specify only a device name 

You specified something other than a device name when only a device name 
was valid. 

?PPN does not exist 

The project-programmer number (PPN) you specified as part of the job 
specification does not exist. 

?PPN needed 

The command you typed requires that a PPN be specified. 

Previous logical name assignment replaced 

An informational message to indicate that an ASSIGN command redefined a 
previously defined user logical. 

(Print,Batch) entry <entry-numberxentry-spec> created 

Acknowledgment message to PRINT or SUBMIT command. 

(Print,Batch) entry <entry-spec> - <error text> 

For SET ENTRY, indicates that an entry was not modified for the reason 
stated in the error text. 

?Print/Batch Services already started 

You issued the START/QUEUE/MANAGER command; however, the 
Print/Batch Services (PBS) package is already started. 

?Print/Batch services not r unning 

You issued a command that requires action by PBS; however, the package is 
not running. 

{Print,Batch} queue <queue-name> assigned to server <server-name> 

Acknowledgment message for ASSIGN/QUEUE command. 
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{Print,Batch} queue <queue-name> deassigned from server <server-name> 
Acknowledgment message for DEASSIGN/QUEUE command. 

{Print,Batch} queue <queue-name> closed 

Acknowledgment message for CLOSE/QUEUE command. 

{Print,Batch} queue <queue-name> deleted 

Acknowledgment message for DELETE/QUEUE command. 

% {Print,Batch} queue <queue-name> - <error text> 

For SET QUEUE, indicates that a queue was not modified for the reason 
stated in the error text. 

{Print,Batch} queue <queue-name> marked for deletion 

Acknowledgment message for DELETE/QUEUE command when the queue 
you specified still has entries on it. The queue is deleted as soon as it 
becomes empty. 

{Print,Batch} queue <queue-name> opened 

Acknowledgment message for OPEN/QUEUE command. 

{Print,Batch} queue <queue-name> started 

Acknowledgment message for START/QUEUE command. 

{Print,Batch} queue <queue-name> stopped 

Acknowledgment message for STOP/QUEUE command. 

{Print,Batch} server <server-name> {deleted,marked for deletion} 

Acknowledgment message for DELETE/SERVER command. 

% {Print,Batch} server <server-name> - < error text> 

For SET SERVER, indicates that a server was not modified for the reason 
stated in the error text. 

{Print,Batch} server <server-name> initialized [non]shareable [with forms <form- 
name>] 

Acknowledgment message for INITIALIZE/SERVER command. 

{Print,Batch} server <server-name> modified 

Acknowledgment message for SET SERVER command. 

{Print,Batch} server <server-name> started 

Acknowledgment message for START/SERVER command. 

{Print,Batch} server <server-name> stopped 

Acknowledgment message for STOP/SERVER command. 

Print/Batch Services started at <time> 

Acknowledgment message when you issue the START/QUEUE/MANAGER 
command to begin Print/Batch Services. 

Print/Batch Services stopped at <time> 

Acknowledgment message for STOP/QUEUE/MANAGER command if no 
jobs are being processed. 
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Print/Batch Services will stop after (completing,aborting) <n> job[s] 

Acknowledgment message for STOP/QUEUE/MANAGER command if any 
jobs are currently in progress. 

?Priority exceeds queue’s maximum 

You specified a priority for a PRINT or SUBMIT entiy larger than the 
maximum allowed for the queue. 

?<privilege> privilege required 

You typed a command that requires some privilege, and you do not have it. 

??Program failure in <program-name> 

This message reports a problem in the software. It is followed on the next 
line by an explanation of the problem. You should verify that the failing 
program is correctly installed. If necessary, you should then submit an SPR. 
The SPR should show the dialogue that preceded the message, the exact 
text of the message, and a list of patches that have been installed in the 
failing program. 

?Program PBS$:PBS.TSK does not exist 

The Pnnt/Batch Services (PBS) program was not found when you issued the 
START/QUEUE/MANAGER command. 

?Protection violation 

This error can occur for reasons similar to the following: 

• You typed a CCL command that your system manager has protected 
against general use. 

• You tried to run a program to which you do not have execute access. 

• You tried to read a file to which you do not have read access. 

• You tried to write to or delete a file to which you do not have write 
access. 

If this message occurs because of a protection violation with one of your 
own files, you can use the SET PROTECTION command to change the 
file’s protection code. (However, this error can also occur because of other 
conditions.) 

%Public disk mounted as private 

A user with MOUNT privilege mounted a disk initialized as public without 
specifying /PRIVATE, /PUBLIC, /SHARE, or /NOSHARE. The system 
mounts the disk as private. 

?Qualifier conflicts with file type 

You specified the /APPEND qualifier and the file has RMS attributes. 

?Qualifier conflicts with parameter 

You typed a parameter and a qualifier that should not be present to¬ 
gether. For example, with the DEASSIGN command, you specified the /ALL 
qualifier and a logical name. 

?Queue already assigned to server 

You issued an ASSIGN/QUEUE for a queue already assigned to the server 
you specified. Use the SHOW QUEUE/FULL command to see which servers 
are assigned to a queue. 


(continued on next page) 
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Table D-1 (Cont.): General RSTS/E Messages 


Message and Meaning 

?Queue does not exist 

You specified the name of a queue that does not exist. 

?Queue is {closed,deleted} 

A PRINT or SUBMIT command entry could not be created on a queue 
because the queue is closed or marked for deletion. Use a different queue. 

?Queue is privileged 

The queue you specified in a PRINT or SUBMIT command requires one 
or more privileges that you do not have. Use the SHOW QUEUE/FULL 
command to display the privileges that the queue requires. 

?Queue manager message queue full 

There is no room for additional messages to be sent to PBS at this time. 
Reissue the request. 

?Quoted string expected 

A quoted string or character was expected and was either missing or was 
not enclosed in quotes. 

%Record too long, line truncated 

The record on a READ command was too long. The assignment occurred; 
however, only the first 255 characters were processed. 

?Reserved symbol name 

The user attempted to define a local or global symbol which began with a 
reserved prefix of $, F$ or f$, or delete a reserved global symbol from the 
symbol table that began with the dollar sign ($). 

?Backup set does not contain a valid ANSI label 

The Backup set to restore is not a valid ANSI tape. 

%Backup set volume label is not <volume-name> 

The Backup set volume name does not match the volume name specified by 
the user. 

?Server already exists 

You issued the INITIALIZE/SERVER command to define a server that 
already exists. 

?Server does not exist 

You specified the name of a print or batch server that does not exist. Use 
the SHOW SERVER command to list the defined servers. 

?Single character expected 

A single character inside quotes was expected and more than one character 
was supplied (for example, SET DATA/END_OF_DATA = "$$"). 

?Some file data in file <filename> may be missing 

The Backup set did not contain the number of file blocks which it was 
supposed to contain. If there were other errors, then this indicates that the 
file is missing data. If there are no other errors, submit a SPR with a copy 
of the Backup set. 


(continued on next page) 
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Table D-1 (Cont.): General RSTS/E Messages 


Message and Meaning 
?Source device must be the same 

Two different source devices were specified for the operation. 

?Speed is not allowed for <terminal> 

The speed specified is not one of the speeds allowed for this terminal in the 
TERSPD.SYS file. 

??Stack overflow 

This message indicates a system problem. The system manager should send 
in an SPR, giving the dialogue that preceded the message, the text of the 
message, and a list of patches that have been installed. 

? String too long 

While in an expression, a string became too long to fit in the 255 available 
bytes. 

?Substitution too complex 

The user’s request for apostrophe substitution was rejected because the sub¬ 
stitution was too complex (it reached the maximum number of substitution 
iterations allowed on one command). 

?Summary record not first record of Backup set 

This problem indicates that the Backup set was not written correctly. 
Submit a SPR including a copy of the Backup set. 

?Symbol name conflicts with <symbol-name> 

The user specified an assignment whose symbol name or abbreviation point 
conflicted with an existing symbol definition in the same symbol table. 

?Symbol name too long 

The symbol name specified by the user exceeded 255 characters. 

?? Symbol table full 

You attempted to define a label or symbol when the local or global symbol 
table was already full. Note that if you are in a command procedure when 
your symbol table gets full, the command procedure aborts. 

?Syntax error 

The command has improper syntax. This occurs when there is not a more 
specific message describing the syntax error. 

7THEN clause required 

The action clause was missing on the IF <expression> THEN command or 
on the ON <severity-level> THEN command. 

7THEN keyword required 

The THEN keyword was missing on the IF <expression> THEN command 
or on the ON <severity-level> THEN command. 

?This is not the correct output volume 

The volume ID of the mounted output volume does not match the volume 
name specified in the /OUT_LABEL qualifier. 

?Time limit exceeds queue’s maximum 

You specified a /TIME_LIMIT value in a SUBMIT command larger than the 
maximum allowed for the queue. 


(continued on next page) 
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Table D-1 (Cont.): General RSTS/E Messages 


Message and Meaning 

?Too many arguments 

You used the notation /qualifier=(arg,arg,...) with a qualifier that accepts 
only a single argument. 

?Too many elements in list 

In a list of file specifications or other items (separated by commas or plus 
signs), you indicated more file specifications than are allowed. For example, 
you exceeded one of the following limits: 

• The DIBOL, RENAME, DELETE, and SET PROTECTION commands 
allow six file specifications. 

• The COPY command allows six input file specifications and one output 
file specification. 

• The PRINT and SUBMIT commands allow up to 11 file specifications. 

?Too many files or parameters 

You specified too many file specifications in a PRINT or SUBMIT command, 
or a parameter string in a SUBMIT command is too long to be handled by 
PBS. Reduce the number of file specifications or use a shorter parameter 
string. 

?Too many logical names assigned 

With the ASSIGN command, you exceeded the maximum number of logical 
names. You can only assign up to four logical names (only three logical 
names if any of the logical assignments includes a PPN). 

?Too many open files on unit 

You specified the same magnetic tape or DECtape drive both as input and 
output files on COPY or APPEND. 

?Too many parameters 

This message occurs if you specify more command parameters than the com¬ 
mand can accept. For example, you specified more than eight parameters 
with the /PARAMETERS qualifier. 

?Too many printers initialized 

The device you specified could not be initialized because the maximum 
number of spooling devices has already been initialized. 

?Unable to copy tape command file to disk 

The user specified an indirect command file on magnetic tape, and some 
error occurred when attempting to copy it to a temporary disk file for 
processing. 

??Unable to create DCL work file 

DCL’s work file for storing the user’s symbol tables could not be created on 
disk. The user may be over quota. Corrective action should be taken before 
the user continues processing. 

??Unable to read DCL work file 

The user’s symbol tables could not be read in from the DCL work file. If 
RSTS/E is processing an indirect command file, then control immediately 
returns to the interactive level. 


(continued on next page) 
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Table D-1 (Cont.): General RSTS/E Messages 


Message and Meaning 

?Unable to recover part of Backup set 

This message indicates that BACKUP was unable to recover part of the 
Backup set, after trying to use error recovery data. There will also be other 
messages indicating what data (if any) was detected to be missing. 

?Unable to start Print/Batch Services 
<error message> 

Some external condition, as the error message on the second line describes, 
prevented PBS from being started. 

??Unable to write DCL work file 

The user’s symbol tables could not be written out to the DCL work file. The 
user may be over quota. Corrective action should be taken before the user 
continues processing. If RSTS/E is processing an indirect command file, 
then control immediately returns to the interactive level. 

?Unbalanced parentheses 

Parentheses do not match up (for example, A=((5)+6). 

?Undefined label <label> 

The label specified on the GOTO command does not exist in the indirect 
command procedure being executed. 

?Undefined symbol 

The symbol name specified is not defined in the global or local symbol tables. 

?Unexpected character 

A character was encountered in a qualifier or a parameter that was not 
expected. For example, in SET TERMINAL/WIDTH=80FOO, the "F" of 
"FOO" would be an unexpected character. 

?Unexpected error verifying file data for file <filename> 

The RSTS/E monitor reported an error in response to BACKUP’S request to 
verify data. Another message describing the problem follows this message. 

?Unexpected error writing to output file <filename> 

The RSTS/E monitor reported an error when writing to the specified file. 
Another message describing the problem follows this message. 

?Unit number required 

This message occurs when you specify a device-name without a device¬ 
number (for example, DM: instead of DMO:). 

?Unsupported record structure level - record skipped 

This message indicates that the version number of a record was higher than 
the highest version known to BACKUP. If this error occurs trying to restore 
a Backup set written by a newer version of BACKUP on an older version of 
BACKUP, the operation may not work properly. If the version of BACKUP 
writing the tape is older or the same as the one doing the RESTORE, submit 
an SPR with a copy of the Backup set that generated the error. 

?User macros nested too deep 

There were more than 50 nested user macros or a user macro called itself. 


(continued on next page) 
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Table D-1 (Cont.): General RSTS/E Messages 


Message and Meaning 

%Valid qualifiers are /INITIALIZE and /NOINITIALIZE 

You entered a qualifier other than /INITIALIZE and /NOINITIALIZE and 
those were the only valid qualifiers. 

?Verification failure for directory information for file <filename> 

There was a difference between the directory information (file size, file flags, 
etc) stored on the Backup set and in the directory structure. 

?Verification failure for file attributes for file <filename> 

There was a difference between the file attributes stored on the Backup set 
and in the directory structure. 

?Verification failure for file data for file <filename> 

The file data stored on the Backup set is different from the file data stored 
on disk. 

%Volume has not been initialized 

The initialization request failed, so the output device is not in an initialized 
state. BACKUP reprompts for an input device. 

?Wildcard entry name not allowed 

The command you specified does not allow wildcard entry names. Specify 
the name of a single entry instead. 

?Wildcards not allowed 

You included a wildcard in a file specification, where wildcards are not 
allowed. 

?Wildcard PPN not allowed 

The command you specified does not allow wildcard PPNs. Specify the name 
of a single PPN instead. 

?Wildcard queue name not allowed 

The command you specified does not allow wildcard queue names. Specify 
the name of a single queue instead. 

%XOR block missing from Backup set 

If this error occurs without any other messages, submit an SPR with a copy 
of the Backup set. If there are other messages, this has probably occurred 
because a block of the Backup set was unreadable. 

%XOR verification failed - group may be unreliable 

This message indicates that BACKUP, during a verify operation, concluded 
that the recovery data for a group of data blocks does not match the data 
found in the blocks. If this was not accompanied by other messages, submit 
a SPR. It it was, consider the data in the Backup set to be unreliable. 
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Appendix E 

SAVRES System Program 


The RSTS/E SAVRES system program is a disk backup and copy utility that has 
operational functions: 

• RESTORE recreates a disk from an archived SAVRES tape or disk. 

• IMAGE makes a copy of a disk. 

• IDENTIFY extracts label information from a SAVRES volume or RSTS/E 
disk. 


E.1 When to Use SAVRES 

SAVRES provides a nonselective, fast-volume image capability that requires few 
operator responses during the operational dialogue. Unlike BACKUP, SAVRES 
processes entire volumes only and does not allow selective file transfers. When 
SAVRES finds bad blocks, it requires no operator intervention. For these reasons, 
use the SAVRES program when you need to: 

• Create a fast, reliable image copy of an entire RSTS/E disk 

• Restore a previously archived SAVRES set 


E.2 Definitions of SAVRES Terms 

To understand this appendix, you should know these terms: 

• SAVE format: The format of the output written by a previous SAVE operation 
and read by a RESTORE operation. These could only be created with versions 
prior to V9.7. 

• SAVE set: The set of magnetic tapes or disks created by a previous SAVE 
operation. A SAVE Set must be composed entirely of disks or tapes; it cannot 
be a combination of the two device types. However, you can mix different 
drive types within one set, for example, two RK05’s and one RK06. 

• SAVE volume: One of the magnetic tapes or disks of a SAVE Set. 
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• SAVE Set Name: One- to six-alphanumeric characters used to identify a 
SAVE set. By default, the SAVE set name is the same as the Pack ID from 
which it was created. However, you can specify another name for the SAVE 
Set. 

• LIKE Disks: Like disks are units of the same device size (that is, the same 
number of data blocks). SAVRES considers the following devices alike: 

— Two RP06 disks 

— An RM02 and an RM03 

— An RP04 and an RP05 

— An RK05 (RK05J) and one unit of an RK05F 

Therefore, if you copied an RM02 to a SAVE Set, the SAVE Set can later be 
restored either to an RM03 or another RM02. 


E.3 Running SAVRES 

You use the SAVRES program off line while running the system initialization 
code INIT.SYS. In reply to the INIT OPTION prompt, type SAVRES. SAVRES 
responds with the SAV/RES FUNCTION prompt. For example: 

Option: SAVRES 

DD-MMM-YY? 14-MAY-90 
HH:MM? 12:15 

SAV/RES Function: 

NOTE 

You must run SAVRES off line to copy (IMAGE) the system disk with 
which you are currently running on line. 

You can also use SAVRES on line, during timesharing. When you do, you must 
not logically mount the RSTS/E disk(s) on which SAVRES operates. This ensures 
the integrity of the data on the disk(s). To run SAVRES on line, type RUN 
$SAVRES. SAVRES then prints its program prompt: 

$ RUN $ SAVRES<RET> 

SAV/RES Function: 

After the SAV/RES FUNCTION prompt appears, as a result of running SAVRES 
either off line or on line, you are under the control of SAVRES and are ready for 
restore processing. 

Next, select from Table E—l one of the operational functions: 

• RE[STORE] 

• IM[AGE] 

• IDfENTIFY] 
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Unless you need to exit SAVRES (by pressing Line Feed or Return, or entering 
Ctrl/Z) or need further help (by typing HE(LP] or pressing the Return key), 
type one of the three functions on your terminal in response to the SAV/RES 
FUNCTION prompt. For example: 

SAV/RES Function: RESTORE<RET> 

This starts the SAVRES program, which immediately prints the first of several 
dialogue questions. The section "SAVRES Dialogue" contains sample dialogues 
for each of the operational functions. 

Table E-l lists the possible responses to the SAVRES prompt. 


Table E-1: SAVRES Functions 


Function 

RE[STORE] 

IM[AGE] 

IDENTIFY] 

HE[LP] 

<RET> or <LF> 


? 

Ctrl/C 

Ctrl/Z 

other 


Description 

Recreates a RSTS/E file-structured disk from a SAVE Set. 

Copies a RSTS/E file-structured disk to a like disk. 

Prints label information and other volume characteristics of a 
SAVE volume or a RSTS/E file-structured disk. 

Prints a table of SAVRES functions. 

Exits the SAVRES program. If you run SAVRES with a RUN 
command, pressing Return or Line Feed returns you to your 
keyboard monitor. If you are running SAVRES off line with 
INIT.SYS, pressing Return or Line Feed returns you to the INIT 
OPTION prompt. 

Displays the ’’Type HELP for help" message on your terminal. 
Produces the same result as pressing the Line Feed key. 
Produces the same result as pressing the Line Feed key. 
Produces the same result as pressing the Return key. 


Your response to the SAV/RES FUNCTION prompt determines the type of 
dialogue SAVRES performs. You can respond to the prompt in several ways: 

• With the function name, such as IMAGE or RESTORE, or by pressing a key 
such as Return, as shown in Table El—1. If you enter only a function, the full 
dialogue follows. See the section "SAVRES Dialogue. 

• With the function name and various switches. For example: 

SAV/RES Function: RESTORE/VERIFY:10-MAY-90 

If you include switches with the function, the dialogue questions follow only 
for the devices to be used and the unspecified switches. See the following 
section. 

• With a full function command line. For example: 

SAV/RES Function: IMAGE DM1:=DMO :MYPAK/VER/NOERR 

If you enter a complete command line, SAVRES does not ask any dialogue 
questions. See the section "Full Function Command Line." 

SAVRES prints messages on your terminal to tell you its status. Some messages 
are for information only; other messages are error conditions that may require 
your attention during the dialogue, mount, transfer, or verification phases of 
SAVRES. 
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When the program finds an error during a dialogue or mount operation, it asks 
you to correct the problem and to retype the appropriate command. Such errors 
never affect the integrity of the data being transferred. 

However, errors that occur while SAVRES is transferring or verifying data can 
jeopardize data. In this case, SAVRES resolves the problem, aborts the run, or 
asks you whether to continue or to abort the program. The program gives you 
information to help you protect your data by printing informational messages and 
error messages on your terminal. 

Finally, SAVRES prints an optional summary report about RESTORE or IMAGE 
operations at the end of the run. This report describes: 

• The operation performed 

• Device information 

• Start date and time statistics 

• Run total statistics, which includes the number of errors found during the 
operation. 


E.4 SAVRES Switches 

You can include SAVRES switches in a function response or in a full function 
command line. There are two types of switches: 

• The verification switch corresponds to questions in the SAVRES dialogue and 
has default settings. If you do not include the switch in a function response, 
the dialogue asks you for that information. 

If you include one of the switches in a function response, SAVRES does not 
ask the corresponding question but does ask the question for the switch you 
did not specify. For example, if you include the /EXPIRATION switch but not 
/VERIFY, SAVRES does not prompt you for an expiration date but does ask 
the verification question. 

If you do not include the switches in the full function command line, SAVRES 
assumes the default settings. For example, if you do not include the /VERIFY 
switch, SAVRES assumes /NOVERIFY. This means if you do not explicitly 
include the /VERIFY switch in a full function command line, SAVRES does 
not compare the data transfer. 

The /STATS and /ERROR switches have no corresponding dialogue questions 
but do have default settings. Therefore, if you do not specify these switches in 
a function response or command line, SAVRES assumes the default settings. 
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Table E-2 lists the allowable SAYRES switches 


Table E-2: SAYRES Switches 


Switch 

Default and Description 

VE[RIFY] 

NOVERIFY 

NOVEtRIFY] 

You can use this switch only for a RESTORE or IMAGE opera¬ 
tion. If you specify the /VE[RIFY] switch, SAVRES compares the 
volume(s) to make sure that the transfer was accurate. 

ST[ATS] 

STATS 

NOSTtATS] 

SAVRES does not automatically print a summary report at the 
end of a run, unless you specify the /ST[ATS] switch with either a 
function response or a full function command line. See the section 
"SAVRES Summary Report." 

ER[ROR] 

ERROR 

NOER[ROR] 

If you do not include the /ERROR switch and a nonfatal error 
occurs during a SAVRES run, SAVRES prints an error message and 
continues processing. This is the default condition. 

You must specify explicitly the /NOERROR switch if you want 
SAVRES to print an error message and terminate as a result of any 
of the errors described in Table E-10. 


E.5 SAVRES Dialogue 

The SAVRES dialogue begins after you run the SAVRES program and respond to 
the SAV/RES FUNCTION prompt. If you type RESTORE, IMAGE, or IDENTIFY, 
the program asks a set of dialogue questions. To give the default answers to these 
questions (printed in angle brackets), just press Return. If you press Return in 
response to a question that has no default, SAVRES repeats the question. 

There are two valid responses to a SAVRES program that can change its 
operating status: 

• Ctrl/Z 

• Ctrl/C 

If you enter Ctrl/Z at any point in the dialogue, SAVRES returns to the previous 
question. A Ctrl/C response aborts the run immediately and returns you to 
the INIT OPTION prompt if you are running off line under the control of the 
INIT.SYS program, or to your keyboard monitor prompt if you are running 
SAVRES on line. SAVRES automatically returns to the SAV/RES FUNCTION 
prompt after the execution of a specified function when you are operating either 
on line or off line. Exit from the INIT version of SAVRES to the OPTION prompt 
by pressing Line Feed or Return. Type Ctrl/Z to the SAV/RES FUNCTION 
prompt to exit the online version of SAVRES. 
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E.5.1 Device Specifications 

SAVRES requires you to use device specifications as responses to several dialogue 
questions. The general format is: 

<device>[:[<id>]][<switch(es)>] 

Device is a two-character device type (for example DU) followed by a one- or 
two-digit unit number in the range 0 to 15. The identification can be either a 
SAVE Set Name or a disk pack identification; the switches are any of those from 
Table E-3. 


Table E-3: SAVRES Device Specification Switches 


Switch 

Description 

/SCRCATCH] 

The /SCRATCH switch is legal only on an output volume device 
specification. If you use the /SCRATCH switch, SAVRES by¬ 
passes most volume label checking. The program always checks 
the label to see if an output volume contains a SAVE Set written 
at the current density. It checks destination disks for bad block 
information. 

/DEN[SITY]:[ 800] 
[1600] 

[6250] 

The /DENSITY switch is legal only for magnetic tape. With this 
switch, you can specify the density at which the tape is to be read. 
If SAVRES cannot read the tape at the specified density, it tries to 
read the tape at the other legal density setting. 


E.5.2 Privileges Required 

You need RDNFS, WRTNFS, and SYSMOD privileges to gain read/write non¬ 
file-structured access to a disk. If a device is restricted, you also need DEVICE 
privilege to gain access to that device. 


E.5.3 Checking the Input Volume 

SAVRES checks the input volume before transferring any actual data and warns 
you of any problem it foresees in restoring or copying the volume. All of the input 
volume error messages that are printed at this point are warning messages only; 
you can recover from them by following appropriate procedures. 
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Table E-4 lists and describes the error messages that result from a problem with 
an input volume. 

Table E-4: SAVRES Input Volume Error Messages 

Message and Meaning 

%%% Input disk has only nn% free clusters. 

Mount it anyway <NO>? 

The input disk has very few clusters that are not allocated. There must 
be at least as many good pack clusters on an output RSTS/E disk as there 
are clusters to be transferred from the original input disk. This message 
indicates that you may encounter problems copying the disk. Type NO or 
press RETURN to return to the previous device prompt. If you type YES, 
SAVRES proceeds with the IMAGE operation. The program also checks the 
output volume to see if the transfer can be made (see the section ’’Checking 
the Output Volume"). At this point, you may want to free up space on the 
input disk by deleting unnecessary files. This increases your chances of 
completing a successful IMAGE. 

%%% This is not the correct volume. 

The pack ID or SAVE Set Name you included with the input device specifi¬ 
cation does not match the name already written on the volume. If SAVRES 
finds that the names do not match, it prints the warning message and then 
issues the input device prompt again. A dismount request follows the warn¬ 
ing message and lists useful information from the volume label of a SAVE 
Set or a RSTS/E file-structured disk. 

%%% This volume has no label. 

The input volume is not a RSTS/E disk or a SAVE Set. SAVRES prints the 
input device prompt again after issuing the warning message. 

%%% Input disk should be rebuilt. 

You removed a disk from a drive without logically dismounting it and then 
attempted to remount it. Perform the clean operation with the ONLCLN 
program or the REFRESH option of INIT.SYS. See the RSTS/E System 
Installation and Update Guide for information on REFRESH. See the 
RSTS/E Utilities Reference Manual for information on ONLCLN. 


E.5.4 Checking the Output Volume 

SAVKES checks the output volume before restoring or copying a RSTS/E disk 
to make sure that each operation ends with the least chance of error. After 
checking the output volume, SAVRES displays messages about the expiration 
date, the label, and the available data space on the destination device. Some of 
the messages are only for your information; the rest warn you of serious output 
device problems. 

When the output volume you are using is labeled a RSTS/E disk, SAVRES prints 
the message: 

*** The volume on dev: is a RSTS disk 
*** Pack ID is <xxxxxx> 

*** Pack will be reinitialized 
Mount it anyway <NO>? 
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If you type NO or press Line Feed or Return, SAVRES returns to the previous 
output prompt. A YES response indicates you want to use the present volume. 

If you restore (RESTORE) or copy (IMAGE) a disk, SAVRES checks whether 
the total number of clusters on the output disk minus the known bad blocks is 
greater than or equal to the number of allocated clusters on the original source 
disk. If there is not enough space and the transfer cannot be made, it prints the 
following message and then returns to the previous device prompt: 

%%% Too many bad blocks on output disk. 

However, if the program decides there are very few free blocks, it prints: 

%%% Only nn% of the output disk clusters are available for relocation. 
Mount it anyway <N0>? 

You must decide whether the number of free clusters is large enough to permit 
a successful SAVRES operation. If you decide it is not, type NO or press Line 
Feed or Return to return to the output prompt. Type YES if you want SAVRES to 
continue the operation. 


NOTE 

Whenever you get this warning message, Digital recommends you use 
another disk for output. If you do not, there is a greater than normal 
chance the operation will not succeed. 

SAVRES normally transfers each allocated pack cluster from the original source 
disk to the same cluster on the output RSTS/E disk. If SAVRES finds the output 
cluster is bad, it tries to relocate the data. If the cluster size of the item being 
moved is larger than the pack cluster size, there must be enough contiguous free 
pack clusters on the output disk to accommodate the entire source cluster. If 
there is not, SAVRES aborts the operation. 

If the specified output is not a RSTS/E disk, the program prints the new SAVE 
Set Name and proceeds without further notice. It does not check the output 
volume label if you specified the /SCRATCH switch. It always attempts to recover 
bad block information from a RSTS/E file-structured and SAVE disk. 


E.5.5 Restoring a RSTS/E Disk using the RESTORE Dialogue 

To recreate a RSTS/E file-structured disk from a SAVE Set, you must perform the 
RESTORE operation. Because SAVRES writes the SAVE Set in the SAVE format, 
no other RSTS/E software can perform this rebuild process. Before transferring 
any data, SAVRES tries to extract bad block information from the destination 
disk and, if it finds any bad blocks, incorporates them into the new BADB.SYS 
file. 

The SAVRES program may find bad blocks during a RESTORE run. If it does, 
it scans the SATT.SYS file to determine if there is a place where the block 
corresponding to a bad block can be relocated. If a large enough area exists on 
the destination disk, the program simply moves the data to the new location and 
modifies the directory information accordingly. 
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The relocation of blocks may require RESTORE to change a file’s characteristics. 
For example, this can occur if the program finds a bad cluster while transferring 
a contiguous file. To relocate the cluster that falls on the bad block, SAVRES 
must make the file noncontiguous. Changes of this type can cause problems, but 
RESTORE preserves the data and informs you of these adjustments. 

The operation ends if there is no way RESTORE can relocate the data cluster. 
This can occur if: 

• No unallocated pack cluster remains on the disk 

• The file cluster size is larger than the pack cluster size and there is not an 
equivalent number of contiguous pack clusters left on the disk 

Normally, SAVRES uses the name of the input SAVE Set as the Pack ID of the 
output volume. After you answer the From Device? question, SAVRES prints a 
message showing you the name it plans to use. The general format is: 

*** SAVE Set name/Default Pack ID is xxxxxx 

After you successfully respond to the TO RSTS DISK question, SAVRES prints 
the message: 

*** Pack ID is xxxxxx 
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Table E—5 lists the RESTORE dialogue questions. An example of a RESTORE 
procedure follows the dialogue description. 


Table E-5: RESTORE Dialogue Questions 


Question 

Response and Description 

From Device? 

<devspec> 

Data is transferred from the specified device. If you include 
a SAVE Set Name in the device specification (see section 
’’Device Specifications”), SAVE/RESTORE checks whether it 
matches the name on the device. If it does not, the program 
prints a warning message (see section ’’Checking the Input 
Volume") and prints the From Device? question again. 


Type 2 characters to specify the input device type, followed 
by the unit number. Include a SAVE Set Name if you 
want SAVE/RESTORE to make sure it matches the one on 
the volume. The device must be physically mounted and 
write-locked. 

To RSTS Dx: Disk? 

<devspec> 

Data from the previously specified SAVE Set is restored to 
this disk. If you include a Pack ID in the device specification, 
it becomes the Pack ID of the restored disk. Otherwise, 
SAVE/RESTORE uses the SAVE Set Name (which may also 
be the Pack ID of the original source disk). Physically mount 
and write-enable the disk. 


Type 2 characters to specify the output device type, followed 
by the unit number. Include a Pack ID if you want to 
override the default. This drive should have a SCRATCH 
volume mounted, and must be write-enabled. 

Verify(Yes or No)<NO>? 

Y[ES] or N[0] 

This is the dialogue form of the /VERIFY switch. If you type 
YES, SAVE/RESTORE compares the output with the input at 
the end of each input volume to make sure the volumes are 
equivalent. Type YES if you want SAVRES to compare the 
input and output volumes at the end of each input volume. 
Type NO or press Line Feed or Return if you do not want 
SAVRES to perform this verification. 

Proceed(Yes or No)? 

Y[ES] or N[0] 

This question lets you either double check your dialogue 
responses and abort the operation if you have made errors, or 
proceed with the RESTORE operation. Type YES to proceed 
with the operation. Type NO to abort and return to the 
SAV/RES Function: prompt. 


NOTE 

If you are using the output of a RESTORE operation as a system disk, 
you must use the INIT.SYS INSTALL option to reinstall the desired 
monitor Save Image Library (SIL). You must also reenter any necessary 
HARDWR suboptions (such as changing Hertz) because the INSTALL 
option clears various items set up by the HARDWR suboptions. This 
procedure is necessary because a disk can be saved with SAVE from 
one system disk and restored with RESTORE on a system with a 
different hardware configuration. 

The following RESTORE example shows the restoration of an RM03 disk from 
the tape SAVE Set created in the previous example. The letters are keyed to the 
explanation that follows this sample. 
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The RESTORE steps are: 

1. Mount the two SAVE Set volumes on drive MM1: and MM2:, write-protected. 

2. Mount the destination disk on DR1:, write-enabled. 

3. Type RUN $SAVRES and press Return. 

O $ RUN $ SAVRE S <RE T > 

© SAV/RES Function: RESTORE<RET> 

© From device? MM1:<RET> 

*** SAVE Set Name/default Pack ID is SAVSET 

© To RSTS DR: Disk? DR1:TSTPAK<RET> 

*** xhe volume on DR1: is a RSTS disk 
*** Pack ID is MYPAK 

*** Pack will be reinitialized 
Mount it anyway <NO>? Y<RET> 

*** Pack ID is TSTPAK 

© Verify (Yes or No) <N0>? <RET> 

© Proceed (Yes or No)? Y<RET> 


*** Begin RESTORE from MM1: to DR1: at 08:28 PM 


Dismount Device: 

MM1: 

Set Name: 

SAVSET 

Seq # : 

1 

Density: 

800 

Creation date: 

Friday, 10-May-90 

Expiration date: 

Saturday, 10-May-91 

Mount volume # 2 of 
Device ? MM2:<RET> 

SAVE Set SAVSET 

Proceed (Yes or No) ? 

Y<RET> 

*** Begin RESTORE from MM2: to DR1: at 08:32 PM 

Dismount Device: 

MM2: 

Set Name: 

SAVSET 

Seq #: 

2 

Density: 

800 

Creation date: 

Friday, 10-May-90 

Expiration date: 

Saturday, 10-May-91 

Dismount Device: 

DR1: 

Pack ID: 

TSTPAK 

Pack Clustersize: 

8 

Creation date: 

Monday, 15-Apr-90 


Please label this volume! 


- RESTORE operation completed at 08:37 PM 
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© Summary Report 

RESTORE of SAVE Set SAVSET to DRlsTSTPAK 


Input Device 
Set Name 
# of volumes 
Density 
Creation date 
Expiration date 


Magtape 
SAVSET 
2 

800 

Friday, 10-May-90 
Saturday, 10-May-91 


Output Device 


DR1: 

TSTPAK 

8 

Monday, 15-Apr-90 


Pack ID 


Pack Clustersize 
Creation date 


RESTORE started on Friday, 10-May-90, at 08:28 PM 


© 


Run Statistics 


Transfer Totals 


Total of 54184 blocks transferred 


Error Totals 


Total of 


0 new bad blocks encountered on destination 


0 files structurally altered. 


Timing Totals: 


Total elapsed time: 0 hrs., 9 mins., 36 secs 
Total wait time: 0 hrs., 0 mins., 16 secs 
Total process time: 0 hrs., 9 mins., 20 secs 


© SAV/RES Function: <Ctrl/Z> 

$ 

The explanation of the RESTORE example follows: 

© Type RUN $SAVRES, and then press Return to run the SAVRES program. 

© Begin the RESTORE operation by typing RESTORE and pressing Return 
in response to the initial SAVRES prompt. Because you need to recreate an 
RM03 from a tape SAVE Set, you select the RESTORE function. 

0 The RESTORE dialogue begins when it prints the From Device? question. In 
response, you specify the device name and the unit number of the SAVE Set 
medium and press Return. Because the input medium is tape, mounted on 
drive number 1, you enter MM1:. If you had included a SAVE Set Name in 
the device specification, RESTORE would have checked it against the name 
already on the set. If they had not matched, RESTORE would have issued a 
warning message informing you of the discrepancy. After you terminate your 
response by pressing Return, RESTORE reads the SAVE Set Name from the 
input medium and displays it on your terminal. 

© Because in this RESTORE operation you are recreating an RM03 disk, you 
respond to the To RSTS DR: Disk? question by typing DR1:TSTPAK. By your 
response, you indicate that the device mnemonic of the RM03 is DR, that it 
is mounted on drive number 1, and that you want it to have a Pack ID of 
TSTPAK. After pressing Return, RESTORE checks the Pack ID of the output 
disk. It then prints a message showing you that the disk is a RSTS/E disk, 
has a Pack ID of MYPAK, and that RESTORE will reinitialize it. RESTORE 
issues a Mount It Anyway? question that gives you the option to mount the 
disk or not. Because the data on the disk is no longer valuable, answer Y and 
press Return. RESTORE then initializes the disk with the new Pack ID. 
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© The comparison of the input data to the data already transferred to the 
destination disk is not essential during this particular run; therefore, you 
press Return to accept the No default. When you ask RESTORE to verify 
the transferred data, you are essentially requesting that RESTORE perform 
two operations rather than one. That is, you make the program perform two 
passes on the data, once for the transfer and once for the comparison. 

© No mistakes were made during the dialogue phase; therefore, RESTORE pro¬ 
ceeds with the operation in reply to your Y response. After you press Return, 
RESTORE displays a message to indicate it has begun the transfer. After 
RESTORE completes the first volume, it prints input medium information, 
asks you to mount the next volume, and asks if you want to continue the 
operation. Again, because there are no errors in the dialogue, RESTORE 
proceeds. RESTORE moves the remaining data to the second volume, issues 
the input and output dismount messages, and informs you that the operation 
is completed. 

© The Summary Report prints the SAVE Set Name, the Pack ID, and label 
information for both the input and output medium, in addition to the date 
and time of the RESTORE operation. 

© The Run Statistics Report prints the number of blocks transferred, the 

number of bad blocks encountered, and the times required to perform various 
operations. 

© RESTORE returns to the SAV/RES FUNCTION prompt when the operation 
has ended. Enter Ctrl/Z to return to your default keyboard monitor (DCL in 
this example). 


E.5-6 Copying a RSTS/E Disk using the IMAGE Dialogue 

The IMAGE function lets you make an equivalent copy of a RSTS/E file- 
structured disk; however, only disk-to-LIKE-disk transfers are legal when 
using the IMAGE operation. LIKE disks are units that have exactly the same 
device size. The SAVRES program handles bad block recovery during an IMAGE 
operation in the same way as RESTORE. 

Table E-6 lists the IMAGE dialogue questions. An example of the IMAGE 
operation follows the dialogue description. 

NOTE 

If you are using the output of an IMAGE operation as a system disk, 
you must use the INIT.SYS INSTALL option to reinstall the desired 
monitor Save Image Library (SIL). You must also reenter any necessary 
HARDWR suboptions (such as changing Hertz) because the INSTALL 
option clears various items set up by the HARDWR suboptions. This 
procedure is necessary because you can make a copy of a disk on one 
system and use the copied disk on another. 
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Table E-6: IMAGE Dialogue Questions 


Question 

Response and Description 

From RSTS Disk? 

<devspec> 

SAVRES transfers all data from the disk specified in the 
device specification response. If you include a Pack ID in the 
device specification, SAVRES checks to see if it matches the 
one actually on the disk. If it does not, the program prints a 
warning message (see section "Checking the Input Volume") 
and prints the From RSTS Disk? question again. 

Type 2 characters to specify the input device type, followed 
by the unit number. Include a Pack ID if you want SAVRES 
to make sure it matches the one on the volume. This device 
must be physically mounted and write-locked. 

To RSTS Dx: Disk? 

<devspec> 

SAVRES transfers all information from the previously 
specified source disk to this disk. If you include a Pack ID in 
the device specification, it becomes the Pack ID of the output 
disk. Otherwise, SAVRES uses the Pack ID of the source 
disk. 

Type 2 characters to specify the output device type, followed 
by the unit number. Include a Pack ID if you want to 
override the default. This drive should have a SCRATCH 
volume mounted, and must be write-enabled. 

Note that the device mnemonic you specify in response to the 
From RSTS Disk? question appears in place of the Dx in the 
To RSTS Dx: Disk? question. In some cases, in your device 
specification response to the To RSTS Dx: Disk? question, 
you may specify a device mnemonic other than the one that 
appeared for Dx. See the discussion of LIKE disks in the 
section "Definitions of SAVRES Terms." 

Verify(Yes or No)<NO>? 

Y[es] or N[o] 

This is the dialogue form of the VER[IFY] switch. If you type 
YES, SAVRES compares the output with the input at the 
end of each output volume to ensure that the volumes are 
equivalent. If you type NO, SAVRES moves on to the next 
question without performing a verify pass. 

Type YES if you want SAVRES to compare the input and 
output volumes at the end of the IMAGE copy operation. 
Type NO or press Line Feed or Return if you do not want 
SAVRES to perform the verification. 

Proceed(Yes or No)? 

Y[ES] or N[0] 

This question lets you either double check your dialogue 
responses and abort the operation if you have made any 
errors or proceed with the IMAGE operation. 

Type YES to proceed with the operation. Type NO to abort 
and return to the SAV/RES Function: prompt. 


After you answer the From RSTS Disk? question, the program prints a message 
in the following general format to tell you the Pack ID it intends to use: 

*** Input Pack ID/default Output Pack ID is XXXXXX 

If you do not want the output disk to have the same name as the input volume, 
specify a different Pack ID in the <devspec> response to the To RSTS DX: Disk? 
question. After you select the Pack ID and answer the question, SAVRES prints: 

*** Output Pack ID is XXXXXX 
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The following procedure describes an IMAGE operation that copies an RA80 to 
an RA80 and verifies the transfer in the same pass. The letters are keyed to the 
explanation that follows this sample. 

The IMAGE function steps are: 

1. Mount the source disk on drive DUO:, write-locked. 

2. Mount the destination disk on drive DU1:, write-enabled. 

3. Type RUN $SAVRES and press Return. 

O $ RUN $SAVRES<RET> 

© SAV/RES Function: IMAGE/NOERROR<RET> 

© From RSTS disk? DUO:<RET> 

*** Input Pack ID/default Output Pack ID is SOURCE 

© To RSTS DU: Disk? DU1:DESTIN<RET> 

*** xhe volume on DU1: is a RSTS disk 
*** Pack ID is OUTPUT 


*** Pack will be reinitialized 
Mount it anyway <NO>? YES<RET> 

*** Output Pack ID is DESTIN 

© Verify (Yes or No) <NO>? YES<RET> 

© Proceed (Yes or No)? YES<RET> 


*** Begin IMAGE copy from DUO: to DU1: at 11:02 AM 
*** Begin VERIFY pass from DUO: to DU1: at 11:04 AM 
*** 0 differences found 


Dismount Device: 

Pack ID: 
Pack Clustersize: 
Creation date: 


DU1: 

DESTIN 

8 

Friday, 10-May-90 


Please label this volume! 

- IMAGE copy operation completed at 11:07 AM 

© Summary Report 

IMAGE copy of DUO:SOURCE to DU1:DESTIN 


Input Device: 

DUO: 


Pack ID: 

SOURCE 


Pack Clustersize: 

8 


Creation date: 

Friday, 

10-May-90 

Output Device: 

DU1: 


Pack ID: 

DESTIN 


Pack Clustersize: 

8 


Creation date: 

Friday, 

10-May-90 


IMAGE copy started on Friday, 10-May-90, at 11:02 AM 


© Run Statistics 

Transfer Totals: 

Total of 24400 blocks transferred 
Error Totals: 

Total of 0 bad compares. 

Total of 0 new bad blocks encountered on source. 

Total of 0 new bad blocks encountered on destination. 
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0 files structurally altered. 
Timing Totals: 


Total 

elapsed time: 

0 hrs., 

5 

mins ., 

22 

secs. 

Total 

wait time: 

0 hrs., 

0 

mins., 

0 

secs. 

Total 

process time: 

0 hrs., 

5 

mins., 

22 

secs. 


© SAV/RES Function: <Ctrl/Z> 

The explanation of the IMAGE example follows: 

© Type RUN $SAVRES and press Return to run the SAVRES program. 

© SAVRES prints the SAV/RES FUNCTION prompt to determine which 
function you want to perform. To create a copy of an RA80, select the 
IMAGE function by typing IM/NOERROR and pressing Return. Attach the 
/NOERROR switch to insure that no data is lost. The /NOERROR switch 
causes SAVRES to end the operation whenever the program finds a run-time 
error. Before the program aborts, it prints an error message indicating the 
source of the problem. 

© In reply to the From RSTS Disk? question, specify the disk from which you 
are to extract the data. Enter the device name and unit number of the input 
disk and end the response by pressing Return. After this response, IMAGE 
reads the Pack ID from the input disk and displays it on your terminal. 

© IMAGE requests the device name and unit number of the output disk. Type 
DB1:DESTIN to indicate that the RA80 is on drive 1 and you want DESTIN 
to be the new Pack ID. As soon as you press Return, SAVRES tells you that 
the output medium is a RSTS/E disk, its Pack ID is OUTPUT, and it will be 
initialized. SAVRES initializes the disk when you type Y and press Return in 
response to the Mount it anyway? question. A message that SAVRES prints 
informs you that the disk was initialized to the specified Pack ID. 

© To insure against losing data, type YES to have IMAGE determine if the 
input data equals the data that was transferred to the output disk. If IMAGE 
finds that the data is not equivalent, it informs you of these differences. 

© You are satisfied that you made no errors in the dialogue sequence and feel 
that the operation should proceed. After you press Return, IMAGE informs 
you when it begins to transfer data and when it begins the verify pass. After 
completing the data comparison, IMAGE prints the number of differences 
found between the two devices. It then issues the output device dismount 
message. Immediately after IMAGE prints the dismount request, it prints a 
message to show you the copy operation ended successfully. 

© IMAGE prints the Summary Report unless you suppress it by using the 
/NOSTATS switch. The report includes the Pack ID and label information of 
each disk, in addition to the date and time that the IMAGE operation was 
run. 

© The Run Statistics Report provides a total figure for the number of blocks 
transferred, the errors encountered, and the times required to perform the 
IMAGE operation. 

© SAVRES returns you to the SAV/RES FUNCTION prompt when the operation 
ends. Enter Ctrl/Z to return to your keyboard monitor (DCL in this example). 
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E.5.7 IDENTIFY Dialogue 

If you want label information from a SAVE Set volume or a RSTS/E file- 
structured disk, use the IDENTIFY function. SAVRES asks only one question 
before the IDENTIFY operation begins. 

Table E—7 lists the IDENTIFY dialogue question. Examples of the IDENTIFY 
operation appear after the table. 

Table E-7: IDENTIFY Dialogue Question 

Question Response and Description 

From Device? <devspec> 

SAVRES prints the device label characteristics of the SAVE Set or 
RSTS/E file-structured disk for the device specified in the dialogue 
response. If you include a SAVE Set Name or Pack ID, SAVRES 
checks to see if it matches the name on the device. If it does not, 
the program prints a warning message (see the section "Checking 
the Input Volume") and then prints the From Device? question 
again. 

Type 2 characters to specify the input device, followed by the unit 
number. Include a SAVE Set Name or Pack ID if you want SAVRES 
to make sure it matches the one on the volume. You must mount 
and write-lock the device (for protection) before responding to the 
From Device? question. 


The following IDENTIFY example shows the label characteristics of both a SAVE 
Set and a RSTS/E disk. The letters are keyed to the explanation that follows this 
sample. 

The IDENTIFY procedures are: 

1. Mount a SAVE Set volume on MM1:, write-locked. 

2. Mount the RSTS/E disk on drive DR1:, write-locked. 

3. Type RUN $SAVRES and press Return. 


o 

© 

© 


$ RUN $ SAVRE S <RE T > 


SAV/RES Function: 


ID MM1:<RET> 


Device: 
Set Name: 
Seq #: 
Density: 
Creation date: 
Expiration date: 


MM1 : 

SAVSET 

1 

1600 

Friday, 10-May-90 
Saturday, lO-May-91 


o 


SAV/RES Function: 


ID DR1:<RET> 


Device: 
Pack ID: 
Pack Clustersize: 
Creation date: 


DR1: 

TSTPAK 

8 

Monday, 15-Apr-90 


© SAV/RES Function: <Ctrl/Z> 


$ 
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O Type RUN $SAVRES and press Return to run the SAVRES program. 

© The SAVRES program prints the SAV/RES FUNCTION prompt. You respond 
to it with the first two letters of the IDENTIFY function and with the device 
name and unit number of the medium you want to identify. Include a Pack 
ID if you want SAVRES to compare the ID you specify with the one on the 
input volume. 

© IDENTIFY prints label information for the tape SAVE Set. 

© SAVRES returns to the SAV/RES FUNCTION prompt. In response, you ask 
SAVRES to identify the disk pack mounted on DR1:. SAVRES prints the 
information as soon as you end your response. 

© Enter Ctrl/Z to return to your keyboard monitor (DCL in this example). 


E.5.8 Full Function Command Line 

Use the full function command line format if you do not want to answer each 
dialogue question separately. The general format is: 

SAV/RES Function:<function><outdevspec>=<indevspec>[<switch(es)>] 

Function can be RE[STORE], IM[AGE], or ID[ENTIFY] and the switches can be 
any of those listed as valid with the associated function (see section "SAVRES 
Switches"). See the section "Device Specifications" for an explanation of the 
device specifications. 

If you specify a full command in response to the SAV/RES FUNCTION prompt, 
SAVRES prints only the PROCEED question (except during an IDENTIFY 
question): 

Proceed (Yes or No)? 

You must type either YES or NO to this question. Type YES to have SAVRES 
begin the operation; type NO to abort. 

SAVRES does the same standard volume label checking during the full function 
command line operation as it does during the longer dialogue procedure. If a 
discrepancy occurs, SAVRES prints the error message and then returns to the 
SAV/RES FUNCTION prompt. At that point, you must type the full function 
command line again. 


E.6 SAVRES and Booting 

SAVRES always attempts to create bootable media. The output of a RESTORE or 
IMAGE copy operation is bootable if the original disk contained an INIT.SYS file 
in [0,1] (even if the original disk was not bootable). 

If a SAVE volume is booted, a portion of INIT.SYS is loaded, allowing you to 
perform the following INIT options: 

• SAVRES 

• DSKINT 

• BOOT 

• HARDWR option specifying the LIST suboption 
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The types of SAVRES operations you can perform depend on the type of device 
you boot from. You can run all three SAVRES options if you boot from a RSTS/E 
disk or a RSTS/E magnetic tape or SAVE volume. If you boot a SAVE volume and 
then perform a RESTORE operation, SAVRES prints a message at completion of 
the run: 

*** Please boot from the system disk 
Boot device? 

You must specify the device name and unit number of a bootable device. 

Table E-8 summarizes the SAVRES operations you can perform while booting 
various devices. 


Table E-8: Booting RSTS/E and SAVE Set Volumes 


Device Booted 
From 

SAVRES Operations 

You Can Perform 

SAVRES Operations You Can 
Perform Afterwards 

RSTS/E Disk or 
Magnetic Tape 

IDENTIFY, IMAGE, RESTORE 

IDENTIFY, IMAGE, RESTORE 

SAVE Set Volume 
(Disk or Tape) 

IDENTIFY, IMAGE 

IDENTIFY, IMAGE, RESTORE 

SAVE Set Volume 
(Disk or Tape) 

RESTORE 

None—You receive a message 
that states you must boot from 
the system disk. 


NOTE 

You cannot use the console bootstrap to boot a magnetic tape SAVE Set 
if: 

• The tape has a density of 1600 bpi. 

• The drive the tape is mounted on has a TM02 formatter. (Use 
the HARDWR LIST suboption of INIT to determine the type of 
formatters on your drives.) 

However, you can boot a 1600 bpi tape on a drive with a TM02 
formatter if you use the BOOT OPTION prompt of INIT.SYS. That 
is, you can boot under these circumstances using software but not 
hardware boot procedures. As an additional restriction, you can boot 
a magnetic tape SAVE Set only on the following drives: TS11, TU45, 
TU80, TU16, TU77, and TE16. 


E.7 Operator Interface During Processing 

SAVRES requires operator intervention at certain points during processing. 
The operator must mount and dismount devices, reset hung devices, and abort 
operations when necessary. The following sections describe these procedures. 
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E.7.1 Mounting and Dismounting Volumes 

A SAVE Set can contain more than a single volume. Because you may be 
processing multivolume SAVE Sets, the SAVRES program contains procedures 
that allow you to mount the additional volumes in a set. When SAVRES needs 
an additional volume to complete a RESTORE operation, it prompts you with the 
message: 

Mount volume #nn of SAVE Set <setnam> 

Device? 


Proceed (Yes or No)? 

The letters nn represent the volume sequence number and <setnam> indicates 
the SAVE Set Name and unit number of the drive on which the next volume has 
been readied. If you mount a device of the same type, you can respond to this 
prompt only with a unit number. After you press Return to terminate your device 
specification, SAVRES performs volume label checking (see section "Checking 
the Input Volume"). At this point, if the additional volume you mount violates 
any SAVRES rule, the program prints the error message immediately after the 
Device? question. 

SAVRES prints a dismount message when: 

• SAVRES completes the data transfer to the output volume in an IMAGE copy 
operation 

• You mount an incorrect volume 

Note that the dismount message SAVRES generates for a SAVE Set (Format 1) 
differs from a dismount message printed for a RSTS/E disk (Format 2): 

Format 1 


Dismount Device: 

Set Name: 
Seq #: 
Density: 

Creation Date: 
Expiration Date: 

Format 2 

Dismount Device: 

Pack ID: 
Pack Clustersize: 
Creation Date: 


<device> 

<setnam> 

nn 

[ 800 ] 

[ 1600 ] 

<(day-of-week), dd-mmm-yy> 
<(day-of-week), dd-mmm-yy> 


<device> 

<packid> 

mm 

<(day of week), dd-mmm-yy> 


The <device> field represents a two character device mnemonic followed by a 
single digit unit number. The SAVE Set Name replaces <setnam>, and the disk 
pack identification replaces <packid> during a valid SAVRES operation. Density 
figures are printed only for magnetic tape SAVE Sets. 
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E.7.2 Re-Accessing Devices 

During an operation you may find that SAVRES does not have access to a 
previously accessible device. If a device does become hung or is write-protected, 
the program notifies you in the warning message: 

%%% Device hung or write-locked 
Retry (Yes or No)? 

Correct the condition causing the problem if possible, and then type YES to 
attempt to gain access to the device. Type NO to abort the attempt. 


E.7.3 Aborting SAVRES 

To end a SAVRES operation at any time, enter Ctrl/C. This returns control to your 
keyboard monitor if you running SAVRES on line. If you are running under the 
control of the INIT.SYS program and the operation ends, INIT.SYS returns you 
to its OPTION prompt. An abort during a RESTORE or IMAGE operation leaves 
the output volume unusable. However, you do not jeopardize any IDENTIFY 
volumes if you choose to abort this operation. 


E.8 SAVRES Summary Report 

SAVRES prints a Summary Report at the end of RESTORE, and IMAGE 
operations. The report identifies the operation that was run, lists characteristics 
of the input and output devices, and generates a list of data transfer, error, and 
timing statistics. It also documents the time and date of the operation. 
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E.8.1 Summary Report Format and Example 

The format of the Summary Report varies with the operation. At times the 
Input Device characteristics (see Figure E-l) identify a SAVE Set, as in the 
case of a RESTORE operation. Thus, depending on the operation, the SAVE Set 
format may be represented under either the Input or Output Device category. 
The RSTS/E disk format may be printed also under the Input or Output Device 
categories. Figure E-l shows the general format of the SAVRES Summary 
Report. 

Figure E-l: Summary Report Format 


IMAGE of disk<packid> to disk<packid> 

RESTORE SAVE Set <setnam> SAVE Set<setname> 


Input Device: 
Pack ID: 
Pack Clustersize: 
Creation date: 


Output Device: 
Set Name: 
# of volumes: 
Density: 

Creation date: 
Expiration date: 


<device> 

<packid> 

nn *RSTS/E disk format 

<day of week, dd-mmm-yy> 

[magnetic tape] 

[disk] 

<setnam> *SAVE Set format 

nn 

[ 800 ] 

[ 1600 ] 

<day of week, dd-mmm-yy> 

<day of week, dd-mmm-yy> 


Run Statistics 
Transfer Totals: 


Total of nnnnnnn blocks transferred 
Error Totals: 


Total of nnn bad compares. 

Total of nnn new bad blocks encountered on source. 
Total of nnn new bad blocks on destination disk. 


Total 

of nnn files 

structurally 

altered. 



Timing Totals: 





Total 

elapsed time: 

nn hrs., 

nn mins. , 

nn 

secs. 

Total 

wait time: 

nn hrs., 

nn mins., 

nn 

secs. 

Total 

process time: 

nn hrs., 

nn mins., 

nn 

secs. 
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E.8.2 Summary Report Run Statistics 


Table EJ—9 lists and describes the run statistics that appear at the end of a 
RESTORE or IMAGE operation. Because each SAVRES operation prints its 
own set of run statistics, Table E-9 also identifies the operations in which each 
run statistic is printed. The operations are identified according to the following 
conventions: 

R = RESTORE operation 
I = IMAGE operation 


Table E-9: Summary Report Run Totals 


Type of Statistic 

Operation and Description 

Transfer Statistics 

Total of blocks transferred 

This number refers to the total number of blocks 
transferred (directory blocks, file blocks). In a SAVE 
operation an extra set of directory blocks is stored at 
the end of a SAVE Set. The total number of blocks 
transferred includes these extra blocks. [RI] 

Error Statistics 

Total of bad compares 

The total number of errors that occurred during the 
VERIFY phase. [RI] 

Total of new bad block errors 

The number of previously unreported bad blocks 
encountered on the source disk. [RI] 

Total of bad block errors on 
destination disk 

The number of previously unreported bad blocks 
encountered on the destination disk. [RI] 

Total of files structurally altered 

The number of files that were structurally altered to 
enable relocation on the destination disk. (This means 
contiguous files were made noncontiguous or placed 
files were moved.) [RI] 

Time Statistics 

Total elapsed time (TE) 

The total amount of real clock time that elapsed 
during the run. [RI] 

Total wait time (TW) 

The amount of real clock time that elapsed while 
waiting for operator responses and magnetic tape 
rewinds. [RI] 

Total process time (TP) 

The amount of real clock time that was used for 
processing (TE-TW=TP). [RI] 


E.9 SAVRES Error Handling 

SAVRES issues dialogue, mount, transfer, and verification error messages. When 
you find an error message during a dialogue or a mount, SAVRES asks you 
to correct the condition, where appropriate, and then asks you to reenter the 
command. Errors you encounter during either of these phases never affect the 
integrity of the data being transferred. 
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NOTE 


When SAVRES reports an error during a transfer or verification 
phase, it has detected a problem that might corrupt the data being 
transferred. Depending on the nature of the error, a single file, or 
perhaps an entire volume, might be affected. Generally, you encounter 
fewer critical errors during a dialogue or mount phase than in a 
transfer or verification operation. 

SAVRES does not report an error when it finds a bad block on the output device, 
unless it is unable to reallocate that block in a way that is transparent to you. 
For instance, the one-block file SHIFT.LES is moved without notice if a free 
cluster can be found. On the other hand, the program issues an error message if 
it must move the placed file, MOVEME.NOT. 

The /NOERROR switch causes SAVRES to abort the run if it finds any condition 
that warrants an error message. If you do not specify the /NOERROR switch, the 
program takes whatever action necessary. SAVRES always informs you of any 
corrective action taken so you have the option of aborting the operation. 

The most important problem that SAVRES encounters during a RESTORE 
or IMAGE copy operation is finding a bad block on a RSTS/E file-structured 
disk when it wants to write to that block. The program attempts to correct the 
problem by performing the following actions in the order listed: 

1. Marks a contiguous file as noncontiguous and relocates the bad cluster but 
not the entire file. 

2. Marks the file as nonplaced if the bad cluster occurs at the beginning of a 
placed file. 

3. Finds enough contiguous free pack clusters on the output disk to hold the 
number of clusters that must be moved. In other words, if the cluster size of a 
file is 16, SAVRES finds 16 free contiguous blocks for the cluster. It proceeds 
if the reallocation worked and aborts if it has not worked. 

SAVRES always tells you about the changes it makes to a file that are caused by 
this bad block processing. If there is no way to relocate a cluster, the program 
aborts the operation. Unless you specify the /NOERROR, SAVRES never 
terminates an operation when it finds a bad block that results in a nonfatal error 
(see the section "SAVRES Switches"). 
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E.9.1 General SAVRES Error Messages 

Table E-10 describes the errors that can occur during SAVRES operations. 

Table E-10: General SAVRES Error Messages 


Message and Meaning 

??? Bad block in MFD 

SAVKES aborts the operation when it finds a bad block in the Master File 
Directory (MFD). 

%%% Bad block in SATT.SYS 

There is a bad block in the input SATT.SYS file. SAVRES does not use an 
input disk that has a corrupt SATT.SYS file. 

%%% Bad data: 

in [MFD] 

[<[P.PN] FILENAME.TYPE>] 

[P,PN]] 

[[GFD, mm] 

A cluster contained in the described account or file could not be relocated 
due to a fatal read error on the output volume. 

??? Bad directory for device 

SAVRES discovered a bad link or bad block in the input or output directory 
structure. 

%%% Bad INIT.SYS on system disk 

SAVRES found a bad block in INIT.SYS while transferring it from the 
system disk to a SAVE Set volume. 

%%% Can’t mix device types in SAVE Set 

A SAVE Set cannot be composed of both tapes and disks. Only all disk or all 
tape SAVE Sets are legal. 

%%% Can’t read bad block file 

SAVRES could not read the bad block file on a RSTS/E disk or a SAVE Set 
volume. 

??? Can’t read SAVE Set volume SATT 

A nonrecoverable I/O error occurred while SAVRES attempted to read the 
Storage Allocation table on the SAVE Set volume. 

%%% Can’t write boot 

The bootstrap could not be written to the first block of the output disk. 

%%% Device hung or write-locked 
Retry (Yes or No)? 

The output device is offline or is write-locked. Correct the condition and try 
again. Type YES to continue or type NO to abort. 

%%% Device mnemonic must be specified 

Enter the device name along with the unit number. 


(continued on next page) 
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Table E-10 (Cont.): General SAVRES Error Messages 


Message Meaning 

%%% Tape won’t respond to any density 

The input volume cannot be read at any legal density setting. 

%%% This is not the correct volume 

The SAVE Set or Pack ID you specified does not match that on the mounted 
device. A DISMOUNT DEVICE message follows the error message and 
identifies the volume if it is a SAVE Set or a RSTS/E file-structured disk. 

This message also occurs if SAVRES requests the next volume of a SAVE Set 
and you specify a device containing a volume that is not part of the current 
SAVE Set or is not the correct sequential volume of the current SAVE Set. 
Mount the correct volume. 

%%% This volume has no label 

SAVRES did not find a valid SAVE Set label or Pack ID on the specified 
input volume. 

%%% Too many had blocks on input disk 

The number of bad clusters on the input disk exceeds the RSTS/E limit. 

%%% Too many bad blocks on output disk 

The number of allocated clusters on the original source disk exceeds the 
number of available clusters on the output disk or the number of bad 
clusters on the output disk exceeds the RSTS/E limit (161 bad clusters). Use 
a different disk pack. 

%%% Unrecognized switch 

You have specified an invalid switch. 

77? Volume is full 

There was not enough room for the relocation of data clusters due to the 
blocks found on the output volume. 

%%% Wrong size disk 

The output volume of an IMAGE or RESTORE must be the same size as the 
original source. See the discussion of LIKE disks in the section ’’Definitions 
of SAVRES Terms.” 

%%% You will be writing to the booted device 

If you write to this device, you need to reboot when you are finished with 
SAVRES. 


E.9.2 Transfer Errors-Fatal and Nonfatal 

Transfer errors you may find in a SAVRES operation can be fatal or nonfatal. 
Fatal transfer errors cause an immediate termination of the current operation. 
Nonfatal errors, if the /NOERROR switch is not in effect, let the operation 
continue despite the problem. On the other hand, if you specify the /NOERROR 
switch and one of the errors in Table E-ll occurs, SAVRES terminates the 
operation immediately (which indicates the output is not a valid medium). In 
other words, the nonfatal errors listed and described in Table E-ll become fatal 
if the /NOERROR is attached to the function response. 

Whether or not you specify /NOERROR, the error message ???Volume is full 
occurs if SAVRES cannot relocate a file due to a bad block on the output device. 
The relocation does not take place because SAVRES cannot find any additional 
clusters available or does not find as many free clusters as it needed. This results 
from too many bad blocks on the output volume. 
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Table E-ll contains a description of all nonfatal transfer errors that can occur if 
you do not specify /NOERROR. 

Table E-11: SAVRES Nonfatal Transfer Errors 


Message and Meaning 

%%% Bad block on input, PCN=nnnnnn 

A bad block was found on an allocated cluster on the input volume. A copied 
version of the data in that block might be corrupt. 

%%% Bad block on input, output PON’s affected: 

A bad block was found on the input SAVE Set volume, which will affect 
certain pack clusters on the output disk. A copied version of the data in that 
block might be corrupt. 

%%% Bad block on input: 

in MFD [PCN=nnnnnn] 

in UFD [P,PN] [, PCN=nnnnnn] 

in GFD, r»rm [, PCN=nnnnnn] 

in file [P,PN]FILENAME.TYPE,[PCN=nnnnnn] 

A bad block was found on an allocated cluster on the input volume. A copied 
version of the data in that block might be corrupt. 

%%% Bad Compare, PCN=nnnnnn 

The data on the input volume did not compare with the corresponding data 
on the output volume. (See the explanation following this table.) 

%%%Bad compare on input: 
in MFD[PCN=nnnnnn] 
in UFD [P,PN] [, PCN=nnnnnn] 
in GFD, nrm [, PCN= n nnnn n ] 
in file [P,PN] FILENAME.TYPE, [PCN=nnnnnn] 

The data on the input volume did not compare with the corresponding data 
on the output volume. (See the explanation following this table.) 

%%% File XXXXXX has been changed to noncontiguous 

SAVRES found a bad block in the output area for file XXXXXX. To complete 
the transfer, one or more blocks of the file were relocated. Consider the 
consequences of this change and proceed accordingly. 

%%% Placed file XXXXXX has been moved from aaaaaa to bbbbbb 

A bad block was found in the output area for file xxxxxx. To complete 
the transfer, one or more blocks of the file were relocated. Consider the 
consequences of this change and proceed accordingly. 


During a verification pass, SAVRES may detect differences between the input and 
output. If there are differences, SAVRES informs you with two types of messages: 

%%%Bad compare, PCN=nnnnn 

%%%Bad compare in [MFD [, PCN=nnnnn]] 

[UFD [p,pn] [, PCN=nnnnn]] 

[GFD, nnn [, PCN=nnnnnn]] 

[file [p,pn]filenam.typ [, PCN=nnnnnn]] 

SAVRES first prints a general error message and then, after some additional 
processing, prints the second error message telling you more specifically the 
accounts and/or files in which the bad comparisons occurred. 
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If you request transfer verification, SAVRES checks (after the initial transfer 
phase) whether the data it has written matches the corresponding data it read. If 
there is a difference, SAVRES prints: 

%%%Bad compare in [MFD [, PCN=nnnnn]] 

The SAVRES program transfers only clusters that are marked as allocated in the 
Storage Allocation Table. During the actual transfer and verify pass, it can tell 
only which Pack Cluster Number (PCN) it has completed. If /NOERROR is in 
effect and you are performing an IMAGE copy, SAVRES then tries to pinpoint 
the problem by scanning the input directory structure before aborting. If you 
are doing a RESTORE, SAVRES simply aborts. This difference exists because 
SAVRES must have a complete directory to scan in order to find accounts and/or 
files that caused the problems. In the case of a RESTORE, the output volume is 
not yet complete and SAVRES cannot scan it. 

If /NOERROR is not in effect, SAVRES stores each PCN that caused a problem 
in an internal table as it continues with the verify pass. If SAVRES finds more 
entries than can be stored in the table, it prints the message: 

"Affected file will not be reported" 

This means there is no more room to store the information. At the end of the 
verification pass, SAVRES prints the total number of variations found in the 
form: 

%%% nn differences found 

After completing the transfer, SAVRES scans the input (IMAGE) or (RESTORE) 
volume directories to find the accounts and/or files in which the bad comparisons 
occurred. Then, it displays one or more of the following messages: 

%%%Bad compare in [MFD [, PCN=nnnnn]] 

[UFD [p,pn] [, PCN=nnnnn]] 

[GFD, nnn [, PCN=nnnnnn]] 

[file [p,pn]filenam.typ [, PCN=nnnnnn]] 
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Appendix F 

Device Testing Package (DEVTST) 


The Device Testing Package (DEVTST) exercises hardware on the RSTS/E 
system during normal timesharing operations. You can use DEVTST to simulate 
hardware errors on the system. 


F.1 Introduction to DEVTST 

DEVTST is a package of programs that provides the customer, System Manager, 
or Digital Field Service personnel with tests that verify the reliability of RSTS/E- 
supported hardware. Execution of any DEVTST program is limited to users with 
WREAD privilege. As distributed, DEVTST is in TEST$: (by default, [0,5]). 

This appendix explains operational data, conventions, complete device testing 
information, and error messages. After execution of individual DEVTST 
exercisers, you should check the System Error Log for additional errors; for more 
information on the System Error Log, see Chapter 10. 

The DEVTST exercisers are tests that can be initiated whenever you suspect 
hardware trouble. These device exercisers generate excess activity in an attempt 
to make the hardware fail during operation. 

Use the DEVTST package in conjunction with the RSTS/E error package (see 
Chapter 10). The Error Logging facility provides the means for determining 
detailed information on hardware errors. In addition, the DEVTST programs 
return error messages that may be useful in determining the failure; however, 
these messages are not as specific as the information provided by the System 
Error Log. 
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The following conventions are used throughout the DEVTST package dialogue: 

< > Indicates the default answer. 


() 

□ 

<ALT MODE> 
or <ESC> 

<Ctrl/Z> 


<Ctrl/C> 


Shows all possible replies. 

Gives an optional reply; for example, ASC [II] means enter ASC, 
ASCI, or ASCII. 

Either key moves the program back one question. If you 

press either key as a response to the first question, DEVTST will 
stop execution and return to the RSTS/E command level. 

Pressing Ctrl/Z causes the program to stop execution and return to 
RSTS/E command level. Ctrl/Z is detected only when the system 
checks for new input. 

Pressing Ctrl/C causes the program to stop execution immediately 
and return to a command level. 


<RET> 
Detach <NO> 


-1 


Use the Return key to terminate the input line. 

All of the device exercisers have the ability to detach; this allows 
you to run an exerciser while keeping your terminal free for other 
operations. 

Negative one, when used as a value for number of iterations, 
pages, or lines, tells the program to run indefinitely, or until you 
press Ctrl/C. 


F.2 DEVTST Operating Procedures 

To run a DEVTST program, type: 

$ RUN TEST$:program name 

For example: 

$ RUN TEST$ rKBEXER 

Table F-l lists the program names and the hardware they test. 


Table F-l: DEVTST Programs 


Program 

Hardware Tested 

CPEXER 

CPU 

CPUTST 

CPU 

DSKEXR 

File-structured disk 

DSKSEK 

Non-file-structured disk 

DXEXER 

Diskette 

KBEXER 

Terminal 

LPEXER 

Line printer 

MTEXER 

Magnetic tape 
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Table F—2 gives a complete list of RSTS/E supported hardware, including 
designators and the associated devices. 


Table F-2: RSTS/E Device Designators 


Device Designator 

Device 

DK:, DL:, DM:, DP:, 

DR:, DB:, DU:, SY: 

SYO: 

DVO: 

DKO: to DK7: 

DLO: to DL3: 

DMO: to DM7: 

DRO: to DR7: 

DBO: to DB7: 

DUO: to DU15: 

RSTS/E public disk structure 

System disk (the unit that was bootstrapped) 
Virtual disk, unit 0 only 

RK05/RK05F disk cartridge units 0 to 7 

RL01/RL02 disk cartridge units 0 to 3 

RK06/RK07 disk cartridge units 0 to 7 

RM02/RM03/RM05/RM80 disk units 0 to 7 

RP04/RP05/RP06 disk pack units 0 to 7 

RA60, RA80, RA81, RC25, RD51, RD52, RD53, 
RX50 disk units 0 to 15 

CR: 

CD: 

MTO: to MT7: 

MSO: to MS3: 

MMO: to MM7: 

MUO: to MU7: 

LPO: to LP7: 

CR11 punched or CM 11 mark sense card reader 

CD 11 punched card reader 

TE10/TU10/TS03 magnetic tape units 0 to 7 
TS11/TSV05/TK25/TU80 magnetic tape units 0 to 3 
TE16/TU16/TU45/TU77 magnetic tape units 0 to 7 
TK50 magnetic tape units 0 to 7 

Line printer units 0 to 7 
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F.3 DEVTST Dialogue Errors 


Table F-3 lists the error messages that can occur in DEVTST programs. 

Table F-3: DEVTST Error Messages 


Message and Meaning 

%Waming: <device name> is a logical device: <device name> will be used. 

DEVTST determines that the device name given is a logical name for another 
device. DEVTST performs a logical device translation and the translated device 
name is used. 

?Illegal device: <device name> specified. 

The device name given by the user is either incorrect or is a logical device name 
that cannot be translated (for example,incorrect characters or the wrong type of 
device). Retry the operation with the correct device name. 

?OPEN failure on <device name>: ( Followed by an error message from Appendix A of 
the RSTS/E System Installation and Update Guide.) 

This error message can mean one of the following: 

• The device specified does not exist 

• No volume was mounted on that device 

• Another user has assigned the device 

• The volume on the device has not been formatted 

• The device is not on line or the device is not write-enabled 

To resolve: retry the operation using the correct option as determined by the 
error message received. 

?Illegal number of iterations selected. 

Retry the operation using the correct number of iterations. 


F.4 CPEXER 


The central processor exerciser is designed to put a heavy load on the Central 
Processing Unit (CPU). CPEXER runs compute bound for bursts and then sleeps 
for five seconds so the average processor loading does not appreciably degrade 
the performance of the system. CPEXER was specifically designed to test the 
Floating Point Processor (FPP) option, but also serves to verify general CPU 
integrity and the Extended Instruction Set (EIS) operation. There is also a test of 
the PEEK function for kernel addresses 0 through 22000. 

The next section itemizes the tests performed by CPEXER. In most of the tests, 
CPEXER compares the results to known correct values. Two heavily compute- 
bound tests are included to verify consistent results of duplicate calculations. 
Finally, CPEXER includes tests that verify FPP divide by zero trap, integer divide 
by zero trap, integer conversion error, and EIS operation. 
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F.4.1 CPEXER Tests 

The CPEXER program includes the following CPEXER tests: 


Test 

Description 

SINCX) 

Uses SIN(X) extended function 

SIN(X) 

Uses polynomial approximation to SINE function 

LOCKX) 

Uses LOG{X) extended function 

EXP(X) 

Uses EXP(X) extended function 

SQR(X) 

Uses SQR(X) extended function 

SQR(X) 

Uses Newton-Raphson method to determine the square 
root 

LOG{EXP(X)) 

Compute-bound test 

ATN(TAN(X)) 

Compute-bound test 

A=1.0/0.0 

Verifies FPP divide by zero trap 

A%=l%/0% 

Verifies integer divide by zero trap 

A%=60000 

Verifies integer conversion error 

INT(40.6621*100+0.5)/l00=40.66 

Verifies EIS operation 

PEEK(X) 

Verifies operation of PEEK function 


F.4.2 CPEXER Dialogue 

The following is an example of the CPEXER dialogue: 

$ RUN TEST$:CPEXER 
CPEXER V10.0 RSTS V10.0 EDERE 
How many minutes to run <15>? 1 

Detach <No>? NO 

11.9 seconds of CPU time used in 1 pass. 

CPEXER finished at 03:36 PM 
$ 


NOTE 

The CPEXER program will build correctly only if the version of BASIC- 
PLUS or BASIC-PLUS-2 includes TRIG and LOG. These mathematical 
functions must be included during system installation of BASIC-PLUS 
or the installation of BASIC-PLUS-2. 
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F.4.3 CPEXER Errors 


This program reports the following types of errors: 

1. Instructions failed to execute. 

2. Errors failed to trap. 

3. Computation errors. 

4. Computation consistency checks failed. 

Check the System Error Log for reported errors. These errors may indicate 
hardware problems. 

When type one errors (instruction errors) occur, CPEXER prints a two-line 
message: the first line gives the test that was being performed and the exact 
error message, and the second line indicates that the test is continuing. For 
example: 

7CPEXER PEEK failed at memory location m. 

-(Error Message) 

Continuing. 

where: 

(Error Message) is the RSTS/E error message from Appendix A of the RSTS/E 

System Installation and Update Guide . 

m is the memory location at which the PEEK function failed. 

Examples of type two errors (trap failure) are: 

7CPEXER Floating point divide by 0 didn't trap 
Continuing. 

7CPEXER Integer divide by 0 didn't trap 
Continuing. 

7CPEXER Forced integer conversion didn't trap 
Continuing. 

7CPEXER (INT(40,6621*100=0.5))/100< >40.66 
Continuing. 

Type three errors (computation errors) give the type of test (SIN,PLYNOM, LOG, 
EXP, SQR, or NEWTON SQR), the error in the computed value, and the location 
of the possible error. For example: 

7CPEXER - SIN test failed for the following cases: 

7CPEXER - Computed value of SIN(40) was .643, should be .64 
7CPEXER - CPU,EIS,FIS,FPP,MUL,DIV or SHIFT Error 
Continuing ... 

7CPEXER - PLYNOM SIN test failed for the following cases: 

7CPEXER - Computed value of PLYNOM SIN (40) was .643, should be .64 
7CPEXER - CPU,EIS,FIS,FPP,MUL,DIV or SHIFT Error 
Continuing... 

7CPEXER - LOG test failed for the following cases: 

7CPEXER - Computed value of LOG (140) was 4.942, should be 4.939 
7CPEXER - CPU,EIS,FIS,FPP,MUL,DIV or SHIFT Error 
Continuing... 

7CPEXER — EXP test failed for the following cases: 

7CPEXER - Computed value of EXP (4) was 54.598, should be 54.599 
7CPEXER - CPU,EIS,FIS,FPP,MUL,DIV or SHIFT Error 
Continuing ... 
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7CPEXER - SQR test failed for the following cases: 

7CPEXER - Computed value of SQR (500) was 22.361, should be 22.362 
7CPEXER - CPU,EIS,FIS,FPP,MUL,DIV or SHIFT Error 
Continuing... 

7CPEXER - NEWTON SQR test failed for the following cases: 

7CPEXER - Computed value of NEWTON SQR (500) was 22.361, should be 22.362 
7CPEXER - CPU,EIS,FIS,FPP,MUL,DIV or SHIFT Error 
Continuing... 

Type four errors (consistency failure) in the CPEXER are shown in the following 
examples: 

7CPEXER - EXP/LOG Consistency check failed for the following cases: 

7CPEXER - EXP(LOG(...( 1 )))))))))) <> EXP(LOG(...( 1)))))))))) 

7CPEXER - EXP(LOG(...( 4 )))))))))) <> EXP(LOG(...( 4)))))))))) 

7CPEXER - CPU,EIS,FIS,FPP,MUL,DIV or SHIFT Error 
Continuing... 

\ 

7CPEXER - ATN/TAN Consistency check failed for the following cases: 

7CPEXER - ATN(TAN(...(-1.5 )))))))))) <> ATN(TAN(...(-1.5 )))))))))) 

7CPEXER - CPU,EIS,FIS,FPP,MUL,DIV or SHIFT Error 
Continuing... 


F.5 CPUTST 

The CPUTST dialogue first asks how many minutes you want the test to run. 
The program then: 

1. Checks for expiration of this request time at eight strategic points during 
each run sequence 

2. Clears and/or sets three 2-dimensional arrays to specified values 

3. Transposes Matrix A and places the result in Matrix B 

4. If no errors are found, returns to step 2 

5. If an error is found, reports the error and aborts the test 

The program repeats this process until the run time expires, at which time it 
prints the CPU time in seconds of expended job time. 


F.5.1 CPUTST Dialogue 

The following is an example of CPUTST dialogue: 

$ RUN TEST$:CPUTST 

CPUTST V10.0 RSTS V10.0 EDERE 

How many minutes to run <15>? 1 

Detach <No>? NO 

6.9 seconds of CPU time used. 

CPUTST Finished at 10:59 AM 

$ 
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F.5.2 CPUTST Errors 


This device exerciser reports errors as shown in the following examples: 
?CPUTST-Error in matrix transposition routine. 

? (Error message) at line mm in CPUTST V10.0. 
where: 

(Error Message) is the RSTS/E message in Appendix A of the RSTS/E System 

Installation and Update Guide for the error that occurred. 

mm is the BASIC-PLUS line number in CPUTST where the error 

occurred. 

Check the System Error Log for reported errors. These errors may indicate 
hardware problems. 

If your hardware does not include a floating point processor (FPP), submit a 
Software Performance Report (SPR) to Digital whenever errors appear. 


F.6 DSKEXR 

This disk exerciser tests the normal operation of all file-structured disks. It 
is possible to run several copies of DSKEXR in order to test several drives 
simultaneously or to put a heavier load on any single drive. The disk must 
be physically and logically mounted. DSKEXR begins by asking questions to 
determine the disk drive to be tested and the number of test iterations to be 
performed. 

After this dialogue, the exerciser: 

1. Opens and extends a temporary file in the current user’s account on the 
specified disk to a predetermined size that is dependent upon disk size and 
the number of free blocks 

2. Loads a pattern buffer with one of four patterns (all l’s and 0’s or a pattern of 
alternating l’s and 0’s) 

3. Writes the file 

4. Reads each block and compares it for each of the patterns. 

Upon completion of all iterations for each drive you specify, DSKEXR prints a 
status report. 

NOTE 

This write operation does not use current disk files to read and write. 

The temporary file will always be deleted after use, regardless of how 
the DSKEXH program is terminated. Be sure to turn off data caching 
before you run this test. 
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F.6.1 DSKEXR Dialogue 

The following is an example of DSKEXR dialogue: 

$ RUN TEST$:DSKEXR 

DSKEXR V10.0 RSTS V10.0 EDERE 

Disk drive to test? DB1: 

Number of test iterations <8>? 1 

Detach <No>? NO 

No errors detected on _DB1: 

$ 


F.6.2 DSKEXR Errors 

DSKEXR reports errors as shown in the following examples: 

?(Error message) error at line mm in DSKEXR V10.0 
?nn errors detected on DBn. 

where: 

(Error message) is the RSTS/E message in Appendix A of the RSTS/E System 

Installation and Update Guide for the error that occurred. 

mm is the line number where the error occurred in the DSKEXR 

program. 

nn is the number of errors detected by DSKEXR. 

When DSKEXH detects errors, do the following: 

1. Check to make sure that the volume is physically mounted and write-enabled. 

2. Check to make sure that the volume is logically mounted. This may be 
verified by the use of the SHOW DISKS command. If the disk is not mounted, 
use the MOUNT command (see Chapter 15). 

CAUTION 

Note the following to avoid damage to the system: 

• Packs mounted as unlocked public disks will be available to other 
system users for creation and storage of their files. Subsequent 
removal of a public disk may result in the elimination of these user 
files from the system. For this reason, Digital recommends the use 
of a private pack if a nonsystem disk is to be tested. 

• Never mount a potentially bad disk on another drive until you are 
sure that the drive and pack are free of physical damage. 

Persistent errors may be due to bad blocks on the pack. Any potentially bad 
blocks will be flagged in the System Error Log following unsuccessful access, to 
prevent further access to the INIT option. 
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F.7 DSKSEK 


This disk exerciser tests the normal operation of non-file-structured disks by 
randomly reading blocks from the disk. It is possible to run several copies of 
DSKSEK in order to test several drives simultaneously or to put a heavier load 
on any single drive. If the disk being tested is a mounted RSTS/E file-structured 
disk, DSKSEK will not read the known bad blocks. If an error occurs on a read 
operation, DSKSEK reports it will be reported by DSKSEK and logs it into the 
System Error Log. 


NOTE 

This is a read-only operation. Turn off data caching before you run this 
test. 


F.7.1 DSKSEK Dialogue 

The following is an example of DSKSEK dialogue: 

$ RUN TEST$:DSKSEK 

DSKSEK V10.0 RSTS V10.0 EDERE 

Disk drive to test? DBO: 

Number of test iterations <30>? 1 

Detach <No>? NO 

No bad block detections in 1000 sets from DBO: 
$ 


F.7.2 DSKSEK Errors 

Errors detected by DSKSEK are displayed as follows: 

?(Error message) error at line mm in DSKSEK V10.0. 

where: 

(Error Message) is the RSTS/E message in Appendix A of the RSTS/E System 

Installation and Update Guide . 

mm is the BASIC-PLUS line number where the error occurred in 

the DSKSEK program. 

When DSKSEK detects errors, do the following: 

1. Check to see if the volume on the testing device is physically mounted. 

2. If it is, mount another scratch volume on the drive and retry the operation. 

CAUTION 

Never mount a potentially bad disk on another drive until you are 
sure that the drive and pack are free of physical damage. 

3. If the test continues to fail, check the System Error Log to see if bad blocks 
are recorded. 
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4. If bad blocks are recorded, add them to the bad block list on the disk using 
the REFRESH BADS suboption of INIT. This can only be done if the disk 
has been initialized (DSKINTed) as a RSTS/E disk. (See the RSTS/E System 
Installation and Update Guide for information on BADS.) 

5. If the problems continue, get a complete listing of the System Error Log 
(using the ERRDIS program). 


F.8 DXEXER 

This exerciser tests the normal operation of the diskette controller and the 
specified diskette drives. DXEXER starts by opening the floppy and writing 
420 blocks of floating point numbers to it. These are written on the drive being 
tested, then read back and verified. The program then displays the number of 
words written and read, and the number of errors detected. 

CAUTION 

DXEXER destroys any information previously contained on the diskette 
used for this test. 


F.8.1 DXEXER Dialogue 

The following is an example of DXEXER dialogue: 

$ RUN TEST$:DXEXER 

DXEXER V10.0 RSTS V10.0 EDERE 

Warning: This exerciser will destroy data on the tested flexible 
diskette. 

Flexible drive to test? DXO: 

Number of iterations <20>? 2 
Detach <No>? NO 

Flexible diskette DXEXER I/O data 
Device Reads Words Writes Words 

_DX0: 300 76.8 K 300 76.8 K 

DXEXER Finished at 10:53 AM 

$ 


F.8.2 DXEXER Errors 

DXEXER shows the number of errors detected during operation as shown in this 
example: 

?mm errors on DXn during iteration nn. 

where: 

mm is the number of errors detected by the DXEXER program. 

DXn is the name of the device being tested. 

nn is the number of the iteration during which the error occurred. 
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When DXEXER detects errors, do the following: 

1. Check to see if the flexible diskette on the testing device is physically mounted 
and the door closed. 

2. If it is, mount another scratch flexible diskette on the drive and retry the 
operation. 


F.9 KBEXER 

The keyboard exerciser (KBEXER) is used to test local and remote terminals 
connected to the RSTS/E system. The three terminal tests are as follows: 

• The Space Test — Verifies that the terminal carriage will return reliably from 
any position 

• The ASCII Pattern Test — Verifies that the terminal will print the standard 
ASCII character set in all print positions 

• The Repeat Test — Repeats everything typed, one line at a time 

NOTE 

You can terminate the tests at any time by pressing Ctrl/C. You can 
obtain HELP by typing HELP in answer to any dialogue question. 


F.9.1 KBEXER Dialogue 

The following is an example of KBEXER dialogue: 

$ RUN TEST$:KBEXER 

KBEXER VI0.0 RSTS VI0.0 EDERE 

Keyboard to test <_KB68:>? <RET> 

Test (SPA[CE], ASC[II], WOR[ST], REP[EAT], HEL[P])? ASC 
Number of test iterations <8>? 1 
Detach <No>? NO 

*** ROTATING ASCII CHARACTERS TEST *** 

#$%&' ()*+,-./0123456789:;<=>? 0ABCDEFGHIJKLMNOPQRSTUVWXYZ[\] A _ !"#$%& 
"#$%&'()*+,-./0123456789:;<=>? ©ABCDEFGHIJKLMNOPQRSTUVWXYZ[\] A _ !"#$% 
!"#$%&' ()*+,-./0123456789:;<=>? @ABCDEFGHIJKLMNOPQRSTUVWXYZ[\] A _ !"#$ 
!"#$%&'()*+,-./0123456789:;<=>? ©ABCDEFGHIJKLMNOPQRSTUVWXYZ[\] A _ !"# 
_ !"#$%&'()*+,-./0123456789:;<=>? ©ABCDEFGHIJKLMNOPQRSTUVWXYZ[\] A _ !" 
A _ !"#$%&' ()* + ,- ./0123456789:;<=>? 0ABCDEFGHIJKLMNOPQRSTUVWXYZ[\] A _ ! 
] A _ !"#$%&' ()*+,-./0123456789:;<=>? @ABCDEFGHIJKLMNOPQRSTUVWXYZ[\] A _ 
\] A _ !"#$%&' ()* + ,-./0123456789:;<=>? 0ABCDEFGHIJKLMNOPQRSTUVWXYZ[\] A _ 

E\] A _ !"#$%&' ()*+,-./0123456789:;<=>? 0ABCDEFGHIJKLMNOPQRSTUVWXYZ[\] A 

Z[\] A _ !"#$%&' ()*+,-./0123456789:;<=>? 0ABCDEFGHIJKLMNOPQRSTUVWXYZ[\] 
YZ[\] A _ !"#$%&'()*+,-./0123456789:;<=>? @ABCDEFGHIJKLMNOPQRSTUVWXYZ[\ 


KBEXER Finished at 10:33 AM 

$ 
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F.9.2 KBEXER Errors 

Errors detected by KBEXER appear as errors in the keyboard test patterns. 
Visually check the patterns for errors. 


F.10 LPEXER 

This exerciser prints a rotating pattern of ASCII characters on a specified number 
of pages and is used to test any line printer. 


F.10.1 LPEXER Dialogue 

The following is an example of LPEXER dialogue: 

$ RUN TEST$:LPEXER 

LPEXER VI0.0 RSTS VI0.0 EDERE 

Line printer to test? LPO: 

Number of pages to output <4>? 1 

Detach <No>? NO 

LPEXER finished at 11:38 AM 

$ 


F.10.2 LPEXER Errors 

Problems found on the line printer appear as errors in the print-out of ASCII 
characters. Visually check the line printer listing and if an error message is 
printed by LPEXER, check to make sure that the line printer selected is on line 
and not out of paper. 


F.11 MTEXER 

The magnetic tape exerciser checks normal operation of the TM11 or TS11 
magnetic tape controller, the RH11/RH70/TM02/TM03 controller, and the 
specified number of 9-track TE10, TU10, TS03, TS11, TU16, TE16, TU45, TU77, 
TU80, TU81, TK25, or TK50 drives. MTEXER allows you to select the drive to 
be tested, the length of tape to be written and the number of iterations to be 
performed. For each iteration, MTEXER initializes the tape, sets the drive to its 
maximum legal density, opens a file and writes data until the specified length of 
tape has been used. MTEXER then rewinds the tape, opens the file for input, 
reads and verifies the data. If errors are detected, MTEXER prints a count of the 
number of bytes found to be incorrect and then proceeds to the next iteration. 

The data pattern used is a worst case NRZI pattern for 9-track drives. The 
pattern is loaded into a 512-byte buffer, and successively greater numbers of 
records are written to the magtape until the requested length of tape has been 
written. Furthermore, the pattern base varies with the iteration number so the 
contents of the pattern buffer also varies on successive iterations. 

CAUTION 

This exerciser overwrites data contained on the magnetic tape used for 
the test. 
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F.11.1 MTEXER Dialogue 

The following is an example of MTEXER dialogue: 

$ RUN TEST$:MTEXER 

MTEXER V10.0 RSTS V10.0 EDERE 

Warning: This exerciser will destroy data on the tested magtape. 

Magtape drive to test?MT2: 

Drive type is TE16/TU45/TU77 
Density (800 or 1600) <800>? <RET> 

Number of feet to test <100>? <RET> 

Number of iterations <2>? 1 

Detach <No>? NO 

Magtape MTEXER I/O Data 

Device Reads Words Writes Words 

_MT2: 387 99.072 K 387 99.072 K 

No errors detected on _MT2: 

$ 

The details of the dialogue vary with the type of drive used. For instance, if you 
use a drive with only one possible density, the dialogue does not include a density 
question like the one in the example. Also, the question about the number of feet 
does not reflect the actual number of feet on a TK50 tape. 

F.11.2 MTEXER Errors 

Magtape errors are reported in these formats: 

?Magtape select error at line nn in MTEXER V10.0. 

?MTEXER-Selection error occurred, 

where: 

nn is the line number in MTEXER at which the error occurred. 

When MTEXER detects errors, do the following: 

1. Check to see if the volume on the testing device is physically mounted, 
write-enabled, and assigned to you. 

2. If it is, mount another scratch volume on the drive and retry the operation. 

3. Check to make sure that the tape path and heads are free of oxide. 
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ABORT command 
OPSER, A-46 
SPOOL, A-26, A435 
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SHOW ENTRY command, 943 
SHOW FILE/SYSTEM command, 12-40 
SHOW LOGICALS command, 12-42 
SHOW PRINTER command, 11-30 
SHOW QUEUE command, 9-46 
SHOW REQUESTS command, 17-11 
SHOW SERVER command, 9-48 
SHOW TERMINAL command, 945 
UNLOAD/OVERLAY command, 14438 
/ALT_MODE qualifier 

SET TERMINAL command, 8-28 
ANALYS 

CRASH.SYS, 12-18 
crash dump data, 10-25 
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/APPLICATION qualifier 

ASSIGN/PORT command, 8-13 
CREATE/PORT command, 8-14 
SHOW/PORT command, 8-40 
Archiving 

OMS log files, 17-4 
ASSIGN/PORT command, 8-12 
ASSIGN/QUEUE command, 9-19 
ASSIGN/SYSTEM command, 12-10, 12-19 
ASSIGN/USER command, 12-10 
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/OUT_LABEL qualifier, 16-16 
/PLACED_POSITION qualifier, 16-16 
/PROMPT qualifier, 16-16 
/QUERY qualifier, 16-17 
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/ASSIST qualifier, 16-19 
/BRIEF qualifier, 16-19 
/BUFFER_SIZE qualifier, 16-19 
/CREATED qualifier, 16-19 
/END qualifier, 16-20 


BACKUP/DIRECTORY command (Cont.) 
/EXCLUDE qualifier, 16-20 
/FULL qualifier, 16-20 
/INCLUDE qualifier, 16-20 
/IN_LABEL qualifier, 16-20 
/LIST_FILE qualifier, 16-20 
/MODIFIED qualifier, 16-19 
/OCCURRENCE qualifier, 16-20 
/OUTPUT qualifier, 16-20 
/PROMPT qualifier, 16-21 
/REWIND qualifier, 16-21 
/SELECT qualifier, 16-21 
BACKUP/IMAGE command, 16-22 to 16-28 
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/BUFFER_SIZE qualifier, 16-24 
/END qualifier, 16-24 
/INITIALIZE qualifier, 16-24 
/IN_LABEL qualifier, 16-24 
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/OUTPUT qualifier, 16-25 
/OUT_LABEL qualifier, 16-25 
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/PROMPT qualifier, 16-25 
/REPLACE qualifier, 16-26 
/VERIFY qualifier, 16-26 
BACKUP command, 16-4 to 16-12 
/ACCOUNT_DATA qualifier, 16-6 
/ASSIST qualifier, 16-6 
/BLOCK_SIZE qualifier, 16-6 
/BUFFER_SIZE qualifier, 16-6 
/CRC qualifier, 16-7 
/CREATED qualifier, 16-7 
/DENSITY qualifier, 16-7 
/END qualifier, 16-8 
/EXCLUDE qualifier, 16-8 
/FI LE_DATA qualifier, 16-8 
/GROUP_SIZE qualifier, 16-8 
/INCLUDE qualifier, 16-8 
/INITIALIZE qualifier, 16-8 
/IN_LABEL qualifier, 16-9 
/LIST_FILE qualifier, 16-9 
/MODIFIED qualifier, 16-7 
/OUTPUT qualifier, 16-10 
/OUT_LABEL qualifier, 16-9 
/PROMPT qualifier, 16-10 
/QUERY qualifier, 16-10 
/REWIND qualifier, 16-10 
/VERIFY qualifier, 16-10 
/BACKUP qualifier 

SET FILE command, 12-37 
Backup sets 

restrictions, 16-5 
BADB.SYS file 

adding bad blocks, 10-8 
Bad blocks 

adding, caution, 10-8 
adding to BADB.SYS, 10-8 
criteria, 10-7 
during RESTORE, E-8 
ERRDIS example, 10-8 
ERRDIS prints list, 10-8 
ERRDIS report, 10-7 
list of potential, 10-4 
report content, 10-7 
SAVRES file changes, E-24 
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Bad blocks (Cont.) 

SAVRES output, E-24 
Base priority 

SET JOB/PRIORITY command, 6-7 
TUNE privilege, 6-7 
UU.PRI system directive, 6-7 
BASIC-PLUS 

keyboard monitor, 1-2 
run-time system, 12-2 
BATCH, A-1 

ANSWER command, A-41 
answering action requests, A-41 
communication paths, A-5 
CONTINUE command, A-42 
default conditions for, A-39 
default receiver identification, A-39 
device type designators, A-42t 
dismount a volume, A-42 
error checking, A-39 
interrupt commands, A-40t 
logical device name, A-38 
modules, A-38 
mount requests, A-41 
OPSER communicate with, A-40 
OPSER package, A-38 
overview, A-5 

processing command file, A-41 
processor, A-38 
pseudokeyboard, A-38 
requests for operator action, A-41 
run, A-38 

startup options, A-39t 
startup procedures, A—41 
BATCH.DCD file 

command decoding, A-5 
Batch jobs, exit status messages, 9-13 
/BATCH qualifier 

INITIALIZE/QUEUE command, 9-25 
SET ENTRY command, 9-35 
SET QUEUE command, 9-39 
SET SERVER command, 9-41 
SHOW ENTRY command, £-43 
SHOW QUEUE command, £-46 
SHOW SERVER command, 9-48 
Batch servers 

CPU limits, £-13 
Print/Batch Services, £-2, £-12 
pseudo keyboards, £-12 
time limits, £-13 
wildcard names, £-12 
/BEFORE=date-time qualifier 

SHOW REQUESTS command, 17-11 
/BELL qualifier 

BROADCAST command, 13-9 
Bit 0, setting, 2-5 
/BLOCK_SIZE qualifier 

BACKUP/COPY command, 16-14 
BACKUP/IMAGE command, 16-23 
BACKUP command, 16-6 
Bootable medium, create with SAVRES, E-18 
Bootstrap 

RSTS/E after system halt, 2-2 
RSTS/E into memory, 2-1 
Bootstrap procedure, 2-1 
/BREAK qualifier 

SET TERMINAL command, 8-29 


/BRIEF qualifier 

BACKUP/DIRECTORY command, 16-19 
RESTORE/DIRECTORY command, 16-37 
SHOW ACCOUNT command, 7-19 
SHOW ENTRY command, £-43 
SHOW QUEUE command, £-46 
SHOW REQUESTS command, 17-11 
SHOW SERVER command, 9-48 
SHOW TERMINAL command, 8-45 
BROADCAST command, 13-3, 13-9 
SEND privilege, 6-5 
/BROADCAST qualifier 

receiving broadcast messages, 6-6 
SET TERMINAL command, 8-29 
Bucket size 
cache, 11-10 
RMS, 11-11 

Buffer status report, SHOW BUFFERS command, 
12-16 

/BU FFER_QUOTA qualifier 

SET TERMINAL command, 8-29 
/BUFFER_SIZE qualifier 

BACKUP/COPY command, 16-14 
BACKUP/DIRECTORY command, 16-19 
BACKUP/IMAGE command, 16-24 
BACKUP command, 16-6 
RESTORE/DIRECTORY command, 16-37 
RESTORE command, 16-30 
Burst pages, A-25 
BYE command, CCL, 3-10 

C 

Cache 

clusters in, 11-8 
data block, 11-7 
size of, 11-8 
space for, 11-8 
updated by the monitor, 11-8 
Cache cluster 

eligible for replacement, 11-9 
last block in, 11-9 
size of, 11-8,11-19 
specify size of, 11-19 
/CACHE qualifier 

SET FILE command, 12-37 
Caching 

checks by monitor, 11—19f 
directory, 11-7 
efficiency of, 11-10 
guidelines, 11-10, 11-11 
MODE checks, 11-10 
optimize directory, 11-11 
override UFD entry, 11-10 
random mode, 11-8 
RMS indexed file, 11-11 
sequential mode, 11-9 
types, 11-7 

UFD entry marked for, 11-9 
Caching Control, DCL commands, 11 —11 
Captive account flag, 7-4 
/CAPTIVE qualifier 

CREATE/ACCOUNT command, 7-6 
SET ACCOUNT command, 7-13 
Catastrophic error, 2-2, 2-5 
automatic recovery, 2-4, 2-5 
cause, 2-4, 2-5 
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Catastrophic error (Cont.) 
handling, 2-5 
recovery, 2-5 

CCL (Concise Command Language) 
adding CCL commands, 12-12 
adding in sequence, 12-13 
BYE command, 3-10 
command definition, 3-10 
defined at start of time sharing, 12-12 
definition, 1-1 
error checking, 12-12 
HELLO command, 3-10 
listing, 12-13 
PLEASE, A-45 
redefining, 3-10 

removing CCL commands, 12-14 
run RSTS/E programs, 12-11 
use of small buffers, 3-10 
CCL command, definition, 12-12 
CHANGECONSOLE command 
OPSER, A-13 
CHARS.QUE file, A-35 
character generation, A-4 
CLOSE/QUEUE command, 9-20 
/CLOSE qualifier 

DETACH command, 13-11 
INITIALIZE/QUEUE command, 9-25 
Cluster size 

cache and pack, relationship, 11-9 
cache and RMS bucket size, 11-10 
disk type, 15-7t 
/CLUSTERSIZE qualifier 

SET CACHE command, 11-20 
/CLUSTER_SIZE qualifier 

CREATE/ACCOUNT command, 7-6 
INITIALIZE command, 15-7 
/132_COLUMNS qualifier 

SET TERMINAL command, 8-28 
Command file 

QUEMAN startup, A-19 
system startup, 3-2 
Command level 
system, 1-11 
terminal at, 1-11 

Command line, full function (RESTORE), E-18 
Commands 

LOAD/OVERLAY, 17-3 
REPLY, 17-6 

SET OPERATOR_SERVICES, 17-8 
SET TERMINAL/OPERATOR__SERVICES, 17-9 
SHOW OPERATOR_SERVICES, 17-10 
SHOW REQUESTS, 17-11 
START/OPERATOR_SERVICES, 17-14 
STOP/OPERATOR_SERVICES, 17-15 
/CONFIRM qualifier 

DELETE/ACCOUNT command, 7-9 
REMOVE/JOB command, 13-16 
Console terminal 

ability to log on to, 13-2 
change, 13-2 
CONTINUE command 
BATCH, A-42 
Controlled access 
privilege, 1-12 
/CONTROL qualifier 

SET TERMINAL command, 8-29 


/CONTROLS qualifier 

INITIALIZE/SERVER command, 9-28 
SET PRINTER command, 11-24 
SET SERVER command, 9-41 
/CONVERT qualifier 

PRINT command, 9-31 
/COPIES=n qualifier 

PRINT command, 9-31 
CPEXER program 

CPU exerciser, short, F-4 
CPU integrity test, F-4 
EIS operation test, F-4 
example dialogue, F-5 
FPP test, F-4 

LOG feature requirement, F-5 
PEEK function test, F-4 
tests performed, F-5 
TRIG feature requirement, F-5 
type four errors, F-7 
type one errors, F-6 
type three errors, F-6 
type two errors, F-6 
CPU (Central Processing Unit) 
determine the state of, 2-3 
CPU exerciser, F-4 
CPU integrity test 

CPEXER program, F-4 
CPUTST program, F-7 
errors, F-8 

example dialogue, F-7 
/CPU_LIMIT=n qualifier 

SET ENTRY command, 9-35 
SUBMIT command, 9-59 
/CPUJJMIT qualifier 

INITIALIZE/QUEUE command, 9-25 
SET QUEUE command, 9-39 
Crash 

analyzing system, 10-22 
causes of system, 2-5 
documenting system, 10-22 
error code, 10-25 
handling of system, 2-5 
memory dump, annotated version, 10-24 
OPSER starts after system, A-14 
random system, 2-5 
running QUEMAN after system, A-20 
system, 2-2, 2-5 
CRASH.SYS file, 10-1,10-22 
crash dump, 12-18 
Crash file 

CRASH.SYS, 12-18 
information from, 10-1 
/CRC qualifier 

BACKUP command, 16-7 
CREATE/ACCOUNT command, 7-5 
/CAPTIVE qualifier, 7-6 
/CLUSTER_SIZE qualifier, 7-6 
/DETACHED_JOB_QUOTA qualifier, 7-6 
/DIALUP qualifier, 7-6 
/EXPIRE qualifier, 7-6 
/INTERACTIVE qualifier, 7-7 
/IN_QUOTA qualifier, 7-7 
/JOB_QUOTA qualifier, 7-7 
/LOG qualifier, 7-7 
/LOOKUP qualifier, 7-7 
/MESSAGE_QUOTA qualifier, 7-7 
/NAME qualifier, 7-7 
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CREATE/ACCOUNT command (Cont) 

/NETWORK qualifier, 7-7 
/OUT_QUOTA qualifier, 7-7 
/PASSWORD_PROMPT qualifier, 7-8 
/POSITION qualifier, 7-8 
/PRIVILEGE qualifier, 7-8 
/RIB_QUOTA qualifier, 7-8 
/SIZE qualifier, 7-8 
/TEMPLATE qualifier, 7-8 
/USER qualifier, 7-8 
CREATE/PORT command, 8-14 
/APPLICATION qualifier, 8-14 
/LAT qualifier, 8-14 
/LOGICAL_NAME qualifier, 8-15 
/LOG qualifier, 8-15 
/QUEUED qualifier, 8-15 
/REMOTE__PORT qualifier, 3-15 
/SERVICE qualifier, 8-15 
/SYSTEM qualifier, 8-15 
/TERMINAL_SERVER qualifier, 8-16 
/USER qualifier, 8-16 
CREATE/SERVICE/DAT command 
/IDENTIFICATION qualifier, 8-17 
/LOG qualifier, 8-17 
/STATIC_RATING qualifier, 8-17 
CREATE/SERVICE/LAT command, 3-17 
CREATE/VIRTUAL_DISK command, 11-12, 11-14 
/ADDRESS qualifier, 11-15 
/LOG qualifier, 11-15 
Create access 

GWRITE privilege, 6-3 
WWRITE privilege, 6-8 
/CREATED qualifier 

BACKUP/COPY command, 16—14 
BACKUP/DIRECTORY command, 16-19 
BACKUP command, 16-7 
RESTORE/DIRECTORY command, 16-37 
RESTORE command, 16-30 
/CRFILL qualifier 

SET TERMINAL command, 8-30 
/CR_PREFIX qualifier 

SET PRINTER command, 11-24 
Ctrl/C 

do not use in QUEMAN, A-16 
FORCE command, 13-4 
SAVRES dialogue, E-5 
typed at terminal, 1-11 
Ctrl/Z 

FORCE command, 13-4 
SAVRES dialogue, E-5 
CUSP (Commonly Used System Program) 
definition, 1-2 

D_ 

Data access, cached, 11-8 
Data block 
cache, 11-7 
retrieval pointer, 11-2 
Data caching 

cache clusters used, 11-19 

control, 11-7 

disabling, 11-20 

enable on the system, 11-18 

guidelines, 11-9 

memory access, 11-7 

minimum residency time, 11-11 


Data caching (Cont.) 

MODE values, 11-7 
monitor directives, 11-7 
read operations, 11-7 
restriction with DSKSEK program, F-10 
RMS files, 11-11 
support for, 11-7 
write operations, 11 -7 
XBUF allocation, 11-8 
/DATA_MAXIMUM qualifier 

SET CACHE command, 11-20 
/DATE qualifier 

INITIALIZE command, 15-3 
DATES privilege 
system clock, 6-3 
/DATE_FORMAT qualifier 

SET SYSTEM command, 14-31 
DCL (Digital Command Language) 
caution when defining, 3-10 
CCL commands, 3-10 
definition, 1-1 
keyboard monitor, 1-2 
DCL command descriptions 

account management, 7-5 to 7-19 
BACKUP, 16-4 to 16-12 
BACKUP/COPY, 16-12 to 16-18 
BACKUP/DIRECTORY, 16-18 to 13-22 
BACKUP/IMAGE, 16-22 to 16-28 
caching control, 11-12 to 11-30 
device management, 11-12 to 11-30 
disk handling, 15-3 to 16-1 
job management, 13-7 to 14-1 
LAT management, 8-12 to 9-1 
managing logical names, 12-18 to 13-1 
managing system files, 12-18 to 13-1 
Print/Batch Services Package, 9-19 
Print/Batch Services Package (PBS), 9-58 
RESTORE, 16-28 to 16-35 
RESTORE/DIRECTORY, 16-36 to 17-1 
system functions, 14-25 to 16-1 
tape handling, 15-3 to 16-1 
terminal management, 8-12 to 8—44, 9-1 
DCL commands 

account management, 7-11 
disk handling, 1S—11 
job management, 13—11 
logical names, managing, 12—11 
Print/Batch Services, 9-11 
system files, managing, 12—11 
system functions, 14—11 
tape handling, 15—It 
DEALLOCATE command, 11-16 
/ALL qualifier, 11-16 
DEASSIGN/PORT command, 8-18 
/LAT qualifier, 8-18 
/LOG qualifier, 8-18 
DEASSIGN/QUEUE command, 9-21 
/ALL qualifier, 9-21 

DEASSIGN/SYSTEM command, 12-20 
logical name, 12-11 
DECnet/E 

crash analysis, 10-25 
disabling 

during shutdown, 4-4, 4-6 
logins, 4-3 
EVTLOG 

program, 4-6 
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DECnet/E 

EVTLOG (Cont.) 

shutdown phase, 4-9 
interrupt shutdown, 4-6 
Network Services Protocol file, 12-17 
resetting shutdown status, 4-6 
shutdown, 4-6 

example, 4-13 
phase, 4-5 
use of NCP, 4-6 
/DEFAULT qualifier 

INITIALIZE/QUEUE command, 9-25 
SET QUEUE command, 9-39 
Default queues 

Print/Batch Services, 9-3 
DEFINE/COMMAND/SYSTEM command, 12-11, 
12-12, 12-21 

/LINE_NUMBER qualifier, 12-21 
/PRIVILEGES qualifier, 12-21 
/REPLACE qualifier, 12-21 
/DELETABLE qualifier 

SET FILE command, 12-38 
DELETE/ACCOUNT command, 7-9 
/CONFIRM qualifier, 7-9 
/LOG qualifier, 7-9 
/PURGE qualifier, 7-10 
/QUERY qualifier, 7-10 
/RESTE qualifier, 7-10 
/USER qualifier, 7-10 

DELETE/COMMAND/SYSTEM command, 12-14, 
12-22 

/ALL qualifier, 12-22 
DELETE/PORT command, 8-19 
/ABORT qualifier, 8-19 
/LAT qualifier, 8-19 
/LOG qualifier, 8-19 
DELETE/QUEUE command, 9-22 
DELETE/SERVER command, 9-23 
DELETE/SERVICE/LAT command, 8-20 
/LOG qualifier, 8-20 

DELETE/VIRTUAL_DISK command, 11-12, 11-17 
/LOG qualifier, 11-17 
/DELETE qualifier 

PRINT command, 9-31 
SUBMIT command, 9-59 
Delimiter 

keyboard, 13-6 
/DELIMITER qualifier 

SET TERMINAL command, 8-30 
/DENSITY qualifier 

BACKUP command, 16-7 
INITIALIZE command, 15-12 
SET SYSTEM command, 14-31 
/DENSITY switch, SAVRES, E-6 
Description block, run-time system, 12-4, 12-5 
DETACH command, 13-7, 13-11 
/CLOSE qualifier, 13-11 
OPSER, A-13 
QUEMAN, A—16 
Detached job 

check with SYSTAT, 14-11 
SHOW JOBS/DETACHED command, 14-11 
Detached-job quota, 5-3 
/DETACHED__JOB_QUOTA qualifier 
CREATE/ACCOUNT command, 7-6 
SET ACCOUNT command, 7-13 
Device designators, F-3t 


Device designators (Cont.) 

table of BATCH, A-42t 
Device management, DCL commands, 11—11 
DEVICE privilege 

restricted device, 6-3 
/DEVICE qualifier 

INSTALL/SWAP_FILE command, 12-30 
SHOW COUNTERS/LAT command, 8-37 
SHOW SESSIONS command, 8-42 
Device sizes, disk type, C-2t 
Device testing package 
definition, F-1 
Device Testing Programs 
see DEVTST programs 
/DEVICE_TYPE qualifier 

SET PRINTER command, 11-24 
SET TERMINAL command, 8-30 
DEVTST programs, F-2t 
conventions, F-2 
error messages, F-4t 
how to run, F-2 
/DFLENGTH switch 

effect on line printer, A-26 
effect on terminals, A-26 
SPOOL, A-25 
Dialup flag 

account attribute, 7-4 
dialup line 

ring characteristics, 8-5 
set characteristics, 8-5 
/DIALUP qualifier 

CREATE/ACCOUNT command, 7-6 
SET ACCOUNT command, 7-13 
SET TERMINAL command, 8-30 
Directory 

fragmentation, 1-11 
minimize search overhead, 1-10 
reducing accesses, 11-2 
restructure with REORDR, 11-2 
Directory caching, 11-7 

cache clusters used, 11-19 
enable on the system, 11-18 
GFD, 11-7 
MFD, 11-7 

optimize, 11-11, 12-14 
overlay code, 11-7 
UFD, 11-7 
Directory structure 

optimizing on disk, 11-2 
prevent a damaged, 11-4 
/DIRECTORY_MAXIMUM qualifier 
SET CACHE command, 11-20 
Dirty disk 

rebuilding with MOUNT, 15-16 
when dirty bit is set, 15-14 
/DISABLE qualifier 

SET CACHE command, 11-20 
SET DEVICE command, 11-22 
SET NODE/LAT command, 8-21 
Disk 

copying with IMAGE, E-13 
create fast copy, E-1 

differences between Level 0 and Level 1, 1-7 

directory entries scattered, 11-2 

dismount under SHUTUP, 4-10 

formatting with DSKINT option of INIT.SYS, 15-2 

free space, 14-11 
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Disk (Cont.) 

IMAGE output as system, E-13 
legal with IMAGE, E-13 
MFD on system, 1-11 
optimizing, 1-10 

directory structure, 11-2 
organization, 1-3 
options, 1-3 
private, 1-3, 1-10 

rebuilding a dirty disk with MOUNT, 15-14 

rebuilding with MOUNT command, 15-16 

reorder disk structure, 11-4 

reorder in public structure, 11-4 

restore with SAVRES, E-1 

restoring, E-8 

restructure directories, 11-2 

SAVE Set, E-1 

statistics (DISPLY), 14-19 

status statistics, 14-19 

stopping an RC25, 14-2 

system, 1-2, 1-3 

types, 1-3 

virtual, 11-12 

Disk characteristics, INITIALIZE display, 15-11 
Diskette controller test 
DXEXER program, F—11 
Disk exerciser test 

DSKEXR program, F-8 
Disk handling, DCL commands, 15—11 
Disk quotas, 5-1 
attribute block, 5-1 
logged-in, 5-2 
logged-out, 5-2 
operations, 5-2 
Disk size, disk type, 15—7t 
Disk type, device sizes, C-2t 
DISMOUNT command 
disks, 15-3 

/PUBLIC qualifier, 15-3 
tapes, 15-5 

/UNLOAD qualifier, 15-5 
Displaying messages, 17-3 
DISPLY 

abbreviations in DISPLY report, 14-17 
account location, 14-12 
buffer status report, 12-16 
busy device statistics, 14-19 
commands, 14—14t to14-15t 
detached, 14-12 
disk status abbreviations, 14-20t 
disk structure statistics, 14-19 
example, 14-16 
free buffers, 14-21 
information displayed, 14-13 
INTERVAL question, 14-12 
job status statistics, 14-17 
memory status, 14-23 
abbreviations, 14-24t 
message receivers, 14-20 
abbreviations, 14—211 
resident libraries, 14-23 
abbreviations, 14-22t 
restrict use, 14-12 
running, 14-12 
run-time systems, 14-21 
abbreviations, 14-22t 
screen layout, 14-16 


DISPLY (Cont.) 

STATE column abbreviations, 14—18t 

stop execution, 14-13 

switches, 14-12t 

titles used in report, 14-17 

use, 14-10 

WHY column abbreviations, 14—19t 
DSKCVT program, 1-7 to 1-10 
DSKEXR program 

disk exerciser test, F-8 
errors, F-9 

example dialogue, F-9 
DSKSEK program 

data caching restriction, F-10 
error messages, F-10 
example dialogue, F-10 
non-file-structured disks test, F-10 
DUMP/SYSTEM command, 12-18,12-23 
DXEXER program 

diskette controller test, F—11 
error messages, F—11 
example dialogue, F—11 
Dynamic regions, 5-4 
/DYNAMIC_REGION_LIMIT qualifier 
SET SYSTEM command, 14-31 

E _ 

/EIGHT_BIT qualifier 

SET PRINTER command, 11-24 
SET TERMINAL command, 8-^30 
EIS operation test 

CPEXER program, F-4 

Electronic messaging systems, 14-24 to 14-25 
EMT 

calls, 14-4 
definition, 14-4 
that cannot be logged, 14-8 
EMT logging, 14-4 
anatomy, 14-7 

data contained in packet, 14-9 
data returned, 14-9 
how to program, 14-8 
impact, 14-7 
monitoring usage, 14-6 
packet, 14-9 

reasons for using, 14-4, 14-5 
shutdown under SHUTUP, 4-10 
system security, 14-5 
/EMT_LOGGING qualifier 

SET SYSTEM command, 14-31 
SHOW SYSTEM command, 14-35 
/ENABLE qualifier 

SET CACHE command, 11-20 
SET DEVICE command, 11-22 
SET NODE/LAT command, 8-22 
END command, OPSER, A-45 
/END qualifier 

BACKUP/COPY command, 16-15 
BACKUP/DIRECTORY command, 16-20 
BACKUP/IMAGE command, 16-24 
BACKUP command, 16-8 
RESTORE/DIRECTORY command, 16-38 
RESTORE command, 16-31 
Entry number, accessing entries, 9-7 
Entry specification, accessing entries, 9-7 
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G_ 

GACNT privilege 

account management, 6-3, 6-7 
General small buffer 
DISPLY report, 14-21 
missed errors, 10-10 
SPOOL error, A-29 
use for CCL, 3-10 
GFD (Group File Directory) 

with MFD and UFDs in Level 1, 1—6f 
GREAD privilege 

execute access, 6-3 
read access, 6-3 
/GROUP_SIZE qualifier 
BACKUP command, 16-8 
GWRITE privilege 
create access, 6-3 
rename access, 6-3 
write access, 6-3 

H 

HANGUP command, 13-7, 13-13 
/HANGUP qualifier 

SET SYSTEM command, 14-31 
/HARDCOPY qualifier 

SET TERMINAL command, 8-31 
Hardware 

malfunctions, 2-4 
Hardware controller 

terminal device designator, 8-2 
Hardware errors 
logging, 10-1 
/HEADER qualifier 

BROADCAST command, 13-10 
Heading burst pages, A-25 
HELLO command, CCL, 3-10 
Help report 

ERRDIS (example), 10-6 
/HOLD qualifier 

PRINT command, 9-31 
SET ENTRY command, £-35 
SET JOB command, 13-17 
SET SYSTEM command, 14-31 
SUBMIT command, 9-59 
HOLD state 

processing entries, £-6 
/HOSTSYNC qualifier 

SET TERMINAL command, 8-31 
HWCFG privilege 

SET TERMINAL command, 8-3 
system manager function, 6-3 
terminal characteristics, 8-3 
HWCTL privilege 

system control, 6-4 

I |_ 

/IDENTIFICATION qualifier 

CREATE/SERVICE/LAT command, 8-17 
SET NODE/LAT command, 8-22 
SET SERVICE/LAT command, 8-25 
IDENTIFY, E-3t 
dialogue, E—17t 
example, E-17 


/IGNORE qualifier 

SET FILE command, 12-38 
IMAGE, E-3t 
dialogue, E-13t 
example, E-15 to E-16 
extracting pack ID, E-17t 
output from, as system disk, E-13 
run statistics, E-23 
SAVRES, E-13 
Immediate mode 

shutting down OPSER, 4-8 
/INCLUDE qualifier 

BACKUP/COPY command, 16—15 
BACKUP/DIRECTORY command, 16-20 
BACKUP command, 16-8 
RESTORE/DIRECTORY command, 16-38 
RESTORE command, 16-31 
Indexed file 

caching, 11-11 
/INDEX qualifier 

INITIALIZE command, 15-9 
INIT 

command, 2-5 
start OPSER, A-13 
INIT.BAS program 

OPSER shutdown conditions, 4-8 
INIT.SYS file 

copies to disk, E-18 
INIT.SYS program 
control file, 3-1 

DSKINT option to format disks, 15-2 
use, 2-1 
Initialization code 
bootstrapped, 2-1 
RSTS/E, 2-2 
START option, 3-1 
Initialization options 
discussion, 1-2 
requesting, 2-3 
summary, 2-3t 

INITIALIZE/QUEUE command, £-24 
/BATCH qualifier, £-25 
/CLOSE qualifier, 9-25 
/DEFAULT qualifier, 9-25 
/FORMS qualifier, £-25 
/PAGEJJMIT qualifier, £-26 
/PRINT qualifier, £-26 
/PRIORITY qualifier, 9-26 
/PRIVILEGES qualifier, 9-26 
/TIMEJJMIT qualifier, £-26 
INITIALIZE/SERVER command, 9-28 
/CONTROLS qualifier, £-28 
/FORMS qualifier, 9-28 
/PRIORITY qualifier, £-29 
/RUN_BURST qualifier, £-29 
/SHAREABLE qualifier, 9-29 
INITIALIZE command 

/CLUSTER_SIZE qualifier, 15-7 
/DATE qualifier, 15-8 
/DENSITY qualifier, 15-12 
disks, 15-6 to 15-11 
display of disk characteristics, 15-11 
/ERASE qualifier, 15-8 
/EXERCISE qualifier, 15-8 
/FORMAT qualifier, 15-13 
/INDEX qualifier, 15-9 
/MFD_CLUSTER_SIZE qualifier, 15-9 
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INITIALIZE command (Cont.) 

/NEW_FILES qualifier, 15-10 
/PRIVATE qualifier, 15-10 
/PUBLIC qualifier, 15-10 
QUEMAN, A—15 
/QUERY qualifier, 15-11 
/RETAIN qualifier, 15-11 
tapes, 15-12 
/WRITE qualifier, 15-11 
/INITIALIZE qualifier 

BACKUP/COPY command, 16-15 
BACKUP/IMAGE command, 16-24 
BACKUP command, 16-8 
RESTORE command, 16-31 
Initializing disks 

INITIALIZE command, 15-6 to 15-11 
overview, 15-1 
Initializing tapes 

INITIALIZE command, 15-12 
overview, 15-1 
/INPUT=file-spec qualifier 

SHOW REQUESTS command, 17-11 
/INQUIRE qualifier 

SET TERMINAL command, 8-31 
/INSERT qualifier 

SET TERMINAL command, 8-31 
INSTALL7ERROR_FILE command, 12-14, 12-17, 
12-24 

/LOG qualifier, 12-24 
/POSITION qualifier, 12-24 
/SIZE qualifier, 12-24 
INSTALL/LIBRARY 

DCL command, 12-7, 12-8 
/LOCK qualifier, 12-8 
INSTALL/LIBRARY command, 12-25 
/ADDRESS qualifier, 12-25 
/ERROR_LOGGING qualifier, 12-25 
/LOCK qualifier, 12-26 
/PROTECTION qualifier, 12-26 
/READ_ONLY qualifier, 12-26 
/SHAREABLE qualifier, 12-26 
/UNLOAD qualifier, 12-26 
INSTALL/OVERLAY_FILE command, 12-14, 12-17, 
12-27 

/LOG qualifier, 12-27 
/POSITION qualifier, 12-27 
/SIZE qualifier, 12-27 

install;runtime_system 

/ADDRESS=n qualifier, 12-4 
/LOCK qualifier, 12-6 
/MAXIMUM=s qualifier, 12-6 
/MINIMUM=s qualifier, 12-6 
/[NO]ERROR_LOGGING qualifier, 12-4 
/[NO]KEYBOARD_MONITOR qualifier, 12-4 
/[NO]READ_ONLY qualifier, 12-4 
/[NO]SHAREABLE qualifier, 12-4 
/[NOJUNLOAD qualifier, 12-4 
/POSITION qualifier, 12-5 
/PREFIX=n qualifier, 12-4 
/TYPE qualifier, 12-6 

INSTALL/RUNTIME_SYSTEM command, 3-9, 12-4, 
12-28 

/ADDRESS qualifier, 12-28 
errors, 12-5 

/ERROR_LOGGING qualifier, 12-28 
/KEYBOARD_MONITOR qualifier, 12-29 
/LOCK qualifier, 12-29 


INSTALL/RUNTIME_SYSTEM command (Cont.) 
/MAXIMUM_SIZE qualifier, 12-29 
/MINIMUM_SIZE qualifier, 12-29 
/POSITION qualifier, 12-29 
/PREFIX qualifier, 12-29 
/READJDNLY qualifier, 12-29 
/SHAREABLE qualifier, 12-29 
/TYPE qualifier, 12-29 
/UNLOAD qualifier, 12-29 
INSTALL/SWAP_FILE 
errors, 12-16 
/SIZE=n qualifier, 12-15 
INSTALL/SWAP_FILE command, 12-14, 12-15, 
12-30, 13-2 

/DEVICE qualifier, 12-30 
/LOG qualifier, 12-30 
/POSITION qualifier, 12-31 
/SIZE qualifier, 12-31 
INSTAL privilege 

defining CCLs, 12-11 
system commands, 6-4 
system files, 6-4 
system logical names, 6-4 
/INTERACTIVE qualifier 

CREATE/ACCOUNT command, 7-7 
SET ACCOUNT command, 7-13 
SET TERMINAL command, 8-31 
SHOW/PORT command, 8-40 
INTERRUPT command 

OPSER, A-11, A—12, A—17t, A-44 
response to, A-12 
Interrupt commands 
BATCH, A-40t 
SPOOL, A-30 
/IN_LABEL qualifier 

BACKUP/COPY command, 16-15 
BACKUP/DIRECTORY command, 16-20 
BACKUP/IMAGE command, 16-24 
BACKUP command, 16-9 
RESTORE/DIRECTORY command, 16-38 
RESTORE command, 16-32 
/IN_QUOTA qualifier 

CREATE/ACCOUNT command, 7-7 
SET ACCOUNT command, 7-13 

J 

Job 

accounting information, A-35 
check detached, 14-11 
check number of, 14-11 
compute bound, 13-6 
definition, 1-1 

executing a read request, 11-7 
header, A-35 
keyboard monitor, 1-1 
limit of spooling, A-20 
maximum (JOB MAX), 12-16 
maximum assigned size, 13-7 
number allowed, 12-16 
OPSER checks online, A-5 
OPSER table, A-2 
priority, 13-6 
run burst, A-32 
set maximum size, 13-5 
setting priority, 13-5 
size, 2-6 
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Job (Cont.) 

status statistics, 14-17 
suspend, 13-5 
/JOB=n qualifier 

SHOW REQUESTS command, 17-11 
Job area 
size, 1-11 
user, 1-11 
Job control 

SHOW USER command, 13-4 
JOBCTL privilege 
system control, 5-4 
JOB MAX 

restricts jobs, 12-16 
/JOB qualifier 

ALLOCATE command, 11-13 
Job quota, 5-3 

detached-job, 5-3 
login request, 5-3 
Job run burst, 13-5 
Job status, SYSTAT, 14-11 
Job table, SHUTUP, 4-6 
/JOB_COUNT=n qualifier 
PRINT command, 9-31 
SET ENTRY command, 9-35 
/JOB_END qualifier 

STOP/SERVER command, 9-58 
/JOB_QUOTA qualifier 

CREATE/ACCOUNT command, 7-7 
SET ACCOUNT command, 7-13 

K_ 

/KATAKANA qualifier 

SET TERMINAL command, 8-31 
KBEXER program 

errors, explanation, F-13 
example dialogue, F-12 
local terminals test, F-12 
remote terminals test, F-12 
terminal tests, F-12 
/KEEP=n qualifier 

minimum residency time, 11-11 
/KEEP qualifier 

SET CACHE command, 11-21 
START/OPERATOR_SERVICES command, 17-14 
Keyboard 

controlling, 13-7 
default SPOOL values, A-28 
delimiter, 13-6 
monitor, 1-11 
spooling, A-28 
startup on LAI 80, A-33 
startup on LA36, A-32 
Keyboard monitor, 3-10 
change with SWITCH, 1-1 
default (definition), 1-1 
definition, 1-2 
job, 1-1 

process command, 1-11 
/KEYBOARD_MONITOR qualifier 

INSTALL/RUNTIME_SYSTEM command, 12-29 
SET JOB command, 13-17 


L 

LAI 80 

form length, A-26 
startup keyboard on, A-33 
LA36 

startup keyboard on, A-32 
Label, specified for tapes 

DISMOUNT command, 15-5 
INITIALIZE command, 15-12 
MOUNT command, 15-19 
/LABEL qualifier 

SET SYSTEM command, 14-32 
LAT, 8-8 to 8-11 

enabling at startup, 3-11 
enabling LAT, 8-10 
LAT problems, 8-11 
logins, 13-2 
LAT ports, 8-9 
/LAT qualifier 

ASSIGN/PORT command, 8-13 
CREATE/PORT command, 8-14 
DEASSIGN/PORT command, 8-18 
DELETE/PORT command, 8-19 
SET PORT command, 8-23 
SET SYSTEM command, 8-26, 14-32 
SHOW/PORT command, 8-40 
SHOW SESSIONS command, 8-43 
LAT queueing, 8-9 
Leased lines 

modem control, 8-7 
Level 0, 1—5f 

compared to Level 1, 1-7 
Level 1 

compared to Level 0, 1-7 
three structures involved, 1-6 
Library 

remove resident, 12-8 
resident, 12-7 
LIBRARY keyword, 12-7 
Line printer 

default SPOOL values, A-27 
/DFLENGTH switch effect, A-26 
distinction from terminal, A-27 
form length, A-26 
output, A-35 

recovery from errors, A-34 
requests for output, A-4 
spooling, A-21.A-27 
startup 

all defaults, A-31 
narrow width, A-31 
Line printer test 

LPEXER program, F-13 
/LINE_EDITING qualifier 

SET TERMINAL command, 8-32 
/LINE_NUMBER qualifier 

DEFINE/COMMAND/SYSTEM command, 12-21 
LIST command 
OPSER, A-12 
LIST JOBS command 
OPSER, A-12, A-44 
LIST OPERATORS command 
OPSER, A-12 
/LIST_FILE qualifier 

BACKUP/COPY command, 16-16 
BACKUP/DIRECTORY command, 16-20 
BACKUP/IMAGE command, 16-25 
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/LIST_FILE qualifier (Cont.) 

BACKUP command, 16-9 
RESTORE/DIRECTORY command, 16-38 
RESTORE command, 16-32 
LOAD/INDEX command, 14-26 
LOAD/OVERLAY command, 14-27,17-3 
/ALL qualifier, 14-28 
/LOADABLE_CHARACTERS qualifier 
SET TERMINAL command, 8-32 
Load address 

run-time system, 12-4 
Local Area Transport 
See LAT 

Local terminal test 

KBEXER program, F-12 
/LOCAL_ECHO qualifier 

SET TERMINAL command, 8-32 
/LOCK qualifier 

INSTALL/LIBRARY command, 12-26 
INSTALURUNTIME_SYSTEM command, 12-29 
Log file 
closing 

under SHUTUP, 4-10 
OMS, 17-2 
REQLOG.OMS, 17-2 
LOGFILE command 
OPSER, A—13 
Logged-in quota, 5-2 
EXQTA privilege, 6-3 
Logged-out quota, 5-2 
EXQTA privilege, 6-3 
/LOGGEDJN qualifier 

BROADCAST command, 13-10 
FORCE command, 13-12 
Logical device 
BATCH, A-38 
SPOOL, A-22 
Logical end mode 

shutdown of OPSER, 4-8 
Logical name 

account number associated, 12-9 
adding new, 12-10 
ASSIGN/SYSTEM command, 12-10 
ASSIGN/USER command, 12-10 
DEASSIGN/SYSTEM command, 12-11 
job related, 12-9 
list, 12-11 

managing with DCL commands, 12—It 
system, 12-9 
system defined, 12-9 
unique, 12-9 
/LOGICAL_NAME qualifier 

CREATE/PORT command, 8-15 
LOGIN.COM 

LAT reporting, 8-11 
login command file, 6-9 
LOGIN command, 13-14 
LAT reporting, 8-11 
/OVERRIDE qualifier, 13-14 
/TERMINAL qualifier, 13-15 
Login command file 
LOGIN.COM, 6-9 
Logins 

decrease the number of, 12-16 
limit, 13-2 

limit for DECnet/E, 4-4 
limiting, in SHUTUP, 4-4 
limit under SHUTUP, 4-4 


Logins (Cont.) 

over LAT lines, 13-2 
restricted by swap space, 12-16 
restricting, 13-1 
setting priority, 13-6 
swap file space affects, 12-16 
SWCTL privilege, 6-5 
/LOGINS qualifier 

SET SYSTEM command, 13-19, 14-32 
LOGOUT command, 13-14 
LAT reporting, 8-11 
/LOG qualifier 

ASSIGN/PORT command, 8-13 
CREATE/ACCOUNT command, 7-7 
CREATE/PORT command, 8-15 
CREATE/SERVICE/LAT command, 8-17 
CREATE/VIRTUAL_DISK command, 11-15 
DEASSIGN/PORT command, 8-18 
DELETE/ACCOUNT command, 7-9 
DELETE/PORT/LAT command, 8-19 
DELETE/SERVICE/LAT command, 8-20 
DELETE/VIRTUAL_DISK command, 11-17 
INSTALL/ERROR_FILE command, 12-24 
INSTALL70VERLAY_FILE command, 12-27 
INSTALL/SWAP_FILE command, 12-30 
REMOVE/ERROR_FILE command, 12-32 
REMOVE/SWAP_FILE command, 12-36 
SET ACCOUNT command, 7-13 
SET FILE command, 12-38 
SET NODE/LAT command, 8-22 
SET PASSWORD command, 7-16 
SET PORT command, 8-23 
SET SERVICE/LAT command, 8-25 
SET SYSTEM command, 14-32 
START/LAT command, 8-47 
STOP/LAT command, 8-48 
/LOG_DELETE qualifier 
SUBMIT command, 9-59 
/LOG_FILE=file-spec qualifier 
SUBMIT command, 9-59 
/LOG_QUEUE=queue-name qualifier 
SUBMIT command, 9-59 
/LOOKUP qualifier 

CREATE/ACCOUNT command, 7-7 
SET ACCOUNT command, 7-13 
/LOWERCASE qualifier 

SET PRINTER command, 11-24 
SET TERMINAL command, 8-32 
LPEXER program 

errors, explanation, F-13 
example dialogue, F-13 
line printer test, F-13 

M__ 

Magnetic tape 

density for Save Set, E-20 
/DENSITY switch, E-6 
SAVE Set, E-1, E-19 
Magnetic tape exerciser 
See MTEXER program 
MAKSIL program 

formats disk file, 12-7 
Management 

RSTS/E system, 1-2 
/MAXIMUM qualifier 

SET CACHE command, 11-21 
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/MAXIMUM_SIZE qualifier 

INSTALL/RUNTIME_SYSTEM command, 12-29 
Memory 

adding resident library, 12-8 
available range of, 12-5 
avoiding fragmentation, 12-4 
dump, 10-22 
fragmentation, 12-5 
high, 12-5 
low, 12-5 

status statistics, 14-23 
Memory access 

data caching, 11-7 
Memory dump 

annotated version, 10-24 
critical contents, 10-24 
MESSAGE command 
OPSER, A-10, A-13 
Message quota, 5-4 
Message receiver 
OPSER, A-2 

QUEMAN declares self, A-15 
Message receivers 

abbreviations (DISPLY), 14-21 
statistics (DISPLY), 14-20 
Messages 

? characters, D-1 
% characters, D-1 
general, D-1, D-2t to D-29t 
informational, D-1 
severe error, D-1 
standard error, D-1 
warning, D-1 

/MESSAGE_QUOTA qualifier 

CREATE/ACCOUNT command, 7-7 
SET ACCOUNT command, 7-13 
Messaging systems, 14-24 to 14-25 
MFD (Master File Directory) 
and UFDs in Level 0, 1—5f 
with GFDs and UFDs in Level 1, 1—6f 
/MFD_CLUSTER_SIZE qualifier 
INITIALIZE command, 15-9 
/MINIMUM_SIZE qualifier 

INSTALL/RUNTIME_SYSTEM command, 12-29 
Missed errors 

reported to ERRCPY, 10-9 
Modem control 
leased lines, 8-7 
MODE values 

data caching, 11-7 
/MODIFIED qualifier 

BACKUP/COPY command, 16-14 
BACKUP/DIRECTORY command, 16-19 
BACKUP command, 16-7 
RESTORE/DIRECTORY command, 16-37 
RESTORE command, 16-30 
Monitor 

caching checks, 11—19f 
changing monitors, 2-6 
control of run-time system, 12-2 
customizing, 2-6 
default keyboard, 1-1 
definition, 1-2 

directives (data caching), 11-7 
error detection, 10-1 
job keyboard, 1-1 
keyboard, 1-2 


Monitor (Cont.) 

symbols (list), 10-24 
take online dump, 12-18 
update cache, 11-8 
/MONITOR_NAME qualifier 

SET SYSTEM command, 14-32 
MOUNT command 

/DENSITY qualifier, 15-19 
MOUNT command (disks), 15-14 
/[NOjQUOTA qualifier, 15-16 
/[NOjREBUILD qualifier, 15-16 
/[NOjRESTRICT qualifier, 15-17 
/[NOjWRITE qualifier, 15-18 
/OVERRIDE qualifier, 15-15 
/PRIVATE qualifier, 15-15, 15-16t 
/PUBLIC qualifier, 15-15, 15-16t 
/SHAREABLE qualifier, 15—16t, 15—18 
MOUNT command (tapes), 15-19 
/DENSITY qualifier, 15-19 
/FORMAT qualifier, 15-20 
/OVERRIDE qualifier, 15-20 
/WRITE qualifier, 15-20 
Mounting disks 

DISMOUNT (disks), 15-3 
MOUNT command (disks), 15-14 to 15-19 
overview, 15-2 
Mounting tapes 

DISMOUNT (tapes), 15-5 
MOUNT (tapes), 15-19 
overview, 15-2 
MOUNT privilege 
public disk, 15-14 
shared disks, 6-4 
MS 

shutdown procedures, 4-8 
MSCP 

ERRDIS full report, 10-15 

example, 10-15 to 10-17 
MTEXER program 

error messages, F-14 
example dialogue, F-14 
magnetic tape controllers test, F-13 
magnetic tape drives test, F-13 
/MULTICAST_TIMER qualifier 

SET NODE/LAT command, 8-22 

N 

/NAME=entry-name qualifier 
PRINT command, 9-31 
SUBMIT command, 9-59 
NAME option 
SPOOL, A-24 
/NAME qualifier 

CREATE/ACCOUNT command, 7-7 
SET ACCOUNT command, 7-13 
SET SYSTEM command, 14-32 
NCP 

network shutdown, 4-6 
Network 

shutdown of DECnet/E, 4-5 
Network management 
SWCTL privilege, 6-5 
/NETWORK qualifier 

CREATE/ACCOUNT command, 7-7 
SET ACCOUNT command, 7-13 
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/NETWORK_FILE qualifier 

SHOW FILE/SYSTEM command, 12-40 
/NEWSFILES qualifier 

INITIALIZE command, 15-10 
NEXT command 
error in, A-19 
error text, A-19t 
QUEMAN, A-19 
/NEXT_JOB qualifier 

START/QUEUE/MANAGER command, 9-54 
/NOBROADCAST qualifier, prevents receiving 
broadcasts, 8-6 
/NOCONTIGUOUS qualifier 
SET FILE command, 12-38 
/NODE qualifier 

SHOW COUNTERS/LAT command, 8-37 
Nonfile-structured disk test 
DSKSEK program, F-10 
Nonfile-structured I/O 
RDNFS privilege, 6-5 
WRTNFS privilege, 6-8 
Nonuser account, 7-1 
NORMAL option 

changing in SPOOL, A-24 
SPOOL, A-24 
/NOTIFY qualifier 

PRINT command, 9-31 
SUBMIT command, 9-59 
/[NO]FMS qualifier 

SET SYSTEM command, 8-26, 14-31 
/[NOJOUTPUT qualifier 

SHOW TERMINAL command, 8-45 
/[NO]STATISTICS qualifier 

SET SYSTEM command, 14-33 
NSP (Network Services Protocol) 
cannot remove or add, 12-17 
Number conversion, bit position, B-1 

0 _ 

/OCCURRENCE qualifier 

BACKUP/DIRECTORY command, 18-20 
RESTORE/DIRECTORY command, 16-39 
RESTORE command, 16-32 
ODT (Octal Debugging Tool) 
setting breakpoints with, 12-4 
/OMIT_CR qualifier 

SET PRINTER command, 11-24 
OMS 

displaying messages and requests, 17-3 
facility names, 17-4 
log file, 17-2, 17-4 

operator messages and requests, 17-3 
overview, 17-1 
shutdown in SHUTUP, 4-8 
starting, 17-5 
stopping, 17-6 
system messages, 17-3 
work file, 17-2 
OMS commands, 17—It 
REPLY, 17—It 
REQUEST, 17—It 

SET OPERATOR_SERVICES, 17—It 
SET TERMINAL/OPERATOR_SERVICES, 17-11 
SHOW OPERATOR_SERVICES, 17-1t 
SHOW REQUESTS, 17-1t 
START/OPERATOR_SERVICES, 17—It 


OMS commands (Cont.) 

STOP/OPERATOR_SERVICES, 17—It 
ONLCLN 

perform disk cleaning, E-7 
OPEN/QUEUE command, 8-30 
Operating system 
definition, 1-2 
OPERATOR command 
OPSER, A-13 

Operator communication program, A-43 
Operator messages, 17-3 
/OPERATOR qualifier 

SET TERMINAL command, 8-32 
Operator services 
BATCH, A-1 
flowchart, A-3f 
OPSER, A-1, A-6 
overview, A-1 
QUEMAN, A-1 
RESTOR, A-1 
SPOOL, A-1 
Operator table 
OPSER, A-6 

/OPERATOR_SERVICES qualifier 
SET TERMINAL command, 17-9 
OPER privilege 
shared disks, 6-4 
OPSER 

ABORT command, A-46 
action requests, A-10 
contents, A-1 It 
ANSWER command, A-11 
cause INIT to start, A-13 
CHANGECONSOLE command, A-13 
changes OSC, A-13 
checks for on line jobs, A—4, A-6 
checks operator table, A-6 
commands 

from PLEASE, A-44t 
from SHUTUP, A-45 
START.COM, A-13 
communicates 

three ways, A-4 
with BATCH, A-40 
communicates with SHUTUP, 4-2 
controlled program, A-2 
controlling RESTOR, A-5, A-47 
DETACH command, A-13 
END command, A-45 
immediate shutdown mode, 4-8 
initial operating conditions for, A-13 
interaction with action request, A-4 
interaction with information line, A-4 
interaction with message, A-4 
INTERRUPT command, A-11, A-12, A-17t, A-44 
LIST command, A-12 
LIST JOBS command, A-12, A-44 
LIST OPERATORS command, A-12 
LOGFILE command, A-13 
logical end mode, 4-8 
message 

contents, A-1 It 
formats, A-10 
levels, A-11 

receiver identification, A-2 
MESSAGE command, A—10, A—13 
online job list, A-12t 
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OPSER (Cont.) 

OPERATOR command, A-13 
operator commands, A-8t 
operator communicate with, A-44 
operator table, A-6 
overview, A-2 
RESTOR commands, A-47t 
restrictions of, A-2 
RETYPE command, A-10 
running with SHUTUP, 4-3 
send command to QUEMAN, A-18 
shutdown, A-5 
shutdown in SHUTUP, 4-8 
shutdown procedures, 4-8 
start after system crash, A-14 
starting, A-6 
startup procedure, A-13 
table of online jobs, A-1 
terminating with SHUTUP, A-5, A-45 
valid operators, A-12, A-44 
ways terminated, A-13 
work file, A-6 
OPSER.LOG file 
default log file, A-7 
OPSER package 
BATCH, A-38 
OPSER Package Library 
QUEMAN, A-14 
/OPTIMIZE qualifier 

BACKUP/COPY command, 16-16 
BACKUP/IMAGE command, 16-25 
RESTORE command, 16-32 
Options 

INIT program, 2-5 
OSC (Operator Services Console) 

INTERRUPT responses, A-12 
OPSER broadcasts messages to, A-2 
OPSER changes, A-13 
output formats, A-10 
send text to, A-43 
/OUTPUT qualifier 

BACKUP/COPY command, 16-16 

BACKUP/DIRECTORY command, 16-20 

BACKUP/IMAGE command, 16-25 

BACKUP command, 16-10 

RESTORE/DIRECTORY command, 16-39 

RESTORE command, 16-33 

SHOW/PORT command, 8-40 

SHOW ACCOUNT command, 7-19 

SHOW CACHE command, 11-27 

SHOW COMMAND/SYSTEM command, 12-39 

SHOW COUNTERS/LAT command, 8-37 

SHOW DEVICE command, 11-28 

SHOW DISKS command, 11-29 

SHOW ENTRY command, 9-43 

SHOW FILE/SYSTEM command, 12^10 

SHOW JOB/PRIVILEGE command, 13-20 

SHOW LIBRARY/SYSTEM command, 12-41 

SHOW LOGICALS command, 12-42 

SHOW NODE/LAT command, 8-38 

SHOW OPERATOR_SERVICES command, 17-10 

SHOW PRINTER command, 11-30 

SHOW QUEUE command, 9-46 

SHOW REQUESTS command, 17-11 

SHOW RUNTIME_SYSTEM command, 12-44 

SHOW SERVER command, 9-49 

SHOW SERVICE/LAT command, 8-41 


/OUTPUT qualifier (Cont.) 

SHOW SESSIONS command, 8-43 
SHOW SYSTEM command, 14-35 
SHOW TERMINAL_SERVERS/LAT command, 
8-46 

/OUT_LABEL qualifier 

BACKUP/COPY command, 16-16 
BACKUP/IMAGE command, 16-25 
BACKUP command, 16-9 
RESTORE command, 16-32 
/OUT_QUOTA qualifier 

CREATE/ACCOUNT command, 7-7 
OUT_QUOTA qualifier 

SET ACCOUNT command, 7-13 
Overlay file 

adding, 12-17 
removing, 12-18 

SHOW FILE/SYSTEM command, 12-17 
/OVERLAY_FILE qualifier 

SHOW FILE/SYSTEM command, 12-40 
/OVERRIDE qualifier 

LOGIN command, 13-14 
MOUNT command, 15-15, 15-20 
/OVERSTRIKE qualifier 

SET TERMINAL command, 8-32 
OVR.SYS file 

allocate and position, 12-14 
/OWNER=ppn qualifier 
PRINT command, 9-31 
SUBMIT command, 9-59 

P_ 

Pack identification 

extracting with SAVRES, E—17t 
/PAGE qualifier 

START/QUEUE/MANAGER command, 9-54 
/PAGE_EJECT switch 
SPOOL, A-25 
/PAGE_END qualifier 

STOP/SERVER command, 9-58 
/PAGE_LENGTH qualifier 

SET PRINTER command, 11-24 
/PAGE_LIMIT=n qualifier 
PRINT command, 9-31 
SET ENTRY command, 9-35 
/PAGE_LIMIT qualifier 

INITIALIZE/QUEUE command, 9-26 
SET QUEUE command, 9-39 
PA memory errors, 10-21 
/PARAMETERS qualifier 
SUBMIT command, 9-59 
/PARITY qualifier 

SET TERMINAL command, 8-32 
/PASSWORD_PROMPT qualifier 

CREATE/ACCOUNT command, 7—8 
SET ACCOUNT command, 7-14 
SET SYSTEM command, 14-32 
PBS 

batch servers, 9-2 

default queues, 9-3 

Forms Definition File (FDF), 9-14 

print servers, 9-2, 9-7 

queue manager, 9-2, 9-3 

queue names, 9-3 

queue priorities, 9-5 

queue types, 9-3 
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PBS (Cont.) 

shutdown in SHUTUP, 4-7 
shutdown procedures, 4-7 
treatment by SHUTUP, 4-6 
user interface, 9-2 
using serial printers, 9-11 
PBSCTL privilege 

Print/Batch Services (PBS), 6-4 
PDP-11 word 

decimal values, B-1 
octal values, B-1 
PEEK function test 

CPEXER program, F-4 
/PENDING qualifier 

REPLY command, 17-6 
/PERMANENT qualifier 

SET TERMINAL command, 8-5, 8-^33 
SHOW TERMINAL command, 8-45 
Physical device names, 12-9 
PHYSICAL option 
SPOOL, A—24 
/PLACED qualifier 

SET FILE command, 12-38 
/PLACED_POSITION qualifier 

BACKUP/COPY command, 16-16 
BACKUP/IMAGE command, 16-25 
RESTORE command, 16-33 
.PLAS system directive 
RDMEM privilege, 6-4 
PLEASE 

CCL command, A—45 
commands through OPSER, A-44t 
commands to OPSER, A-44 
message broadcast, A-43 
OPSER commands through, A-44 
restrict use, A-43 
run, A—43 

talks to OPSER, A-3 
terminate, A-43 
Ports 

LAT, 8-9 

/POSITION qualifier 

CREATE/ACCOUNT command, 7-8 
INSTALL/ERROR_FILE command, 12-24 
INSTALL/OVERLAY_FILE command, 12-27 
INSTALL/RUNTIME_SYSTEM command, 12-29 
INSTALL/SWAP_FILE command, 12-31 
Power fail 

automatic restart after, 2-6 
/POWERFAIL_DELAY qualifier 
SET SYSTEM command, 14-32 
/PREFIX qualifier 

INSTALL/RUNTIME_SYSTEM command, 12-29 
Primary run-time system, 12-3 
position, 12-5 
system disk, 1-3 
Print/Batch Services 

ASSIGN/QUEUE command, 9-19 
CLOSE/QUEUE command, 9-20 
DCL commands, 9-11 
DEASSIGN/QUEUE command, 9-21 
DELETE/QUEUE command, 9-22 
DELETE/SERVER command, £-23 
INITIALIZE/QUEUE command, 9-24 
INITIALIZE/SERVER command, 9-28 
managing, 9-2 to 9-13 
many-to-one configuration, 9-4 


Print/Batch Services (Cont.) 

one-to-many configuration, 9-4 
one-to-one configuration, 9-4f 
OPEN/QUEUE command, 9-30 
PBSCTL privilege, 6-4 
SET QUEUE command, 9-38 
SET SERVER command, 9—41 
START/QUEUE/MANAGER command, 9-51 
START/QUEUE command, 9-50 
START/SERVER command, 9-53 
STOP/QUEUE/MANAGER command, 9-56 
STOP/QUEUE command, 9-55 
STOP/SERVER command, 9-57 
Print/Batch Services (PBS), 9-47 
PRINT command, 9-31 

/AFTER=date:time qualifier, 9-31 
/FORMS=form-name qualifier, 9-31 
/HOLD qualifier, 9-31 
/JOB_COUNT=n qualifier, 9-31 
/NAME=entry-name qualifier, 9-31 
/NOTIFY qualifier, 9-31 
/WRAP qualifier, 9-31 

Printer queues using two or more printers, A-34 
Printer servers 
ownership, 9-8 
/PRINTER_PORT qualifier 

SET TERMINAL command, 8-33 
Printing device 

adjustable top of form, A-26 
/PRINT qualifier 

INITIALIZE/QUEUE command, 9-26 
SET ENTRY command, 9-35 
SET QUEUE command, 9-40 
SET SERVER command, 9-42 
SHOW ENTRY command, 9-43 
SHOW QUEUE command, 9-46 
SHOW SERVER command, 9-49 
Print servers 

Print/Batch Services, 9-2, 9-7 
wildcard names, 9-8 
Priority 

basis, 13-5 
byte, 13-6 

format, 13—5f 
decrease for job, 13-6 
description, 13-5 
LOGIN, 13-6 
processing entries, 9-6 
raise for SPOOL, A-32 
setting job, 13-5 
/PRIORITY=n qualifier 
PRINT command, 9-31 
SET ENTRY command, 9-35 
START/OPERATOR_SERVICES command, 17-14 
/PRIORITY qualifier 

INITIALIZE/QUEUE command, 9-26 
INITIALIZE/SERVER command, 9-29 
SET JOB command, 13-17 
SET QUEUE command, 9-40 
SET SERVER command, 9-42 
START/QUEUE/MANAGER command, 9-52 
/PRIORITY switch 
QUEMAN, A-16t 
Private disk, 1-3,1-10 
/PRIVATE qualifier 

INITIALIZE command, 15-10 
MOUNT command, 15-15 
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Privilege 

controlled access, 1-12 
system damage, 1-12 
Privilege bit 

TMPPRV privilege, 6-6 
Privileged job 

programming error, 2-4 
Privilege mask 
authorized, 6-8 
current, 6-8 
saved, 6-8 
/PRIVILEGE qualifier 

CREATE/ACCOUNT command, 7-8 
DEFINE/COMMAND/SYSTEM command, 12-21 
INITIALIZE/QUEUE command, 9-26 
SET ACCOUNT command, 7-14 
SET JOB command, 13-18 
SET QUEUE command, 9-40 
Processing entries 
AFTER state, 9-6 
FORMS_WAIT state, 9-6 
HOLD state, 9-6 
priority, 9-6 
READY state, 9-6 
Program 

system, 1-2 

Program development, 1-2 
Programming errors 
causing crash, 2-5 
/PROMPT qualifier 

BACKUP/COPY command, 16-16 
BACKUP/DIRECTORY command, 16-21 
BACKUP/IMAGE command, 16-25 
BACKUP command, 16-10 
REPLY command, 17-6 
RESTORE/DIRECTORY command, 16-39 
RESTORE command, 16-33 
/PROTECTION qualifier 

INSTALL/LIBRARY command, 12-26 
SET FILE command, 12-38 
Pseudo keyboard 
BATCH, A—38 
use with BATCH, A-5 
Pseudo keyboards, 8-11 
batch servers, 9-12 
/PSEUDO_KEYBOARDS qualifier 

SET SYSTEM command, 8-26, 14-32 
Public disk structure, 1-3 
/PUBLIC qualifier 

DISMOUNT command, 15-3 
INITIALIZE command, 15-10 
MOUNT command, 15-15 
Public structure, 1-2 
/PURGE qualifier 

DELETE/ACCOUNT command, 7-10 

Q 

Qualifiers 

SET ENTRY command, 9-35 
SHOW ENTRY command, £-43 
SHOW QUEUE command, 9-46 
SUBMIT command, 9-59 
QUE, A-^t 
QUE command 
SPOOL, A-35 


QUEMAN 

command received through OPSER, A-18 
commands 

startup, A-19 

consistency checks, A-15, A-20 

DETACH command, A-16 

do not Ctrl/C, A-16 

entry in AFTER queue, A-20 

error in NEXT command, A-19 

initial conditions for spooling queues, A-15 

INITIALIZE command, A-16 

integrity checks, A-15 

message receiver declaration, A-15 

modules, A-14 

OPSER Package Library, A-14 
requirements for running, A-14 
resets to initial states, A-19 
running 

after SHUTUP, A-20 
after system crash, A-20 
running detached, A-16, A-19 
start, A-14 
startup 

command file, A-19 
commands, A-16t 
switches, A-16t 
STATUS command, A-18 
status printout, A-18 
table of online spooling programs, A—4 
/QUERY qualifier 

BACKUP/COPY command, 16-17 
BACKUP command, 16-10 
DELETE/ACCOUNT command, 7-10 
INITIALIZE command, 15-11 
REMOVE/JOB command, 13-16 
RESTORE command, 16-33 
Queue 

printer, A-34 
QUEUE.SYS file, A-A 

clear all entries from, A-15 
consistency checking on, A-20 
corrupt, A-16 
flag value, A-15 
initial conditions, A-15 
number of queue requests, A-20 
/QUEUED qualifier 

ALLOCATE command, 11-13 
ASSIGN/PORT command, 8-13 
CREATE/PORT command, 8-15 
SET PORT command, 8-23 
Queue limits, 9-7 
Queue management, A-14 
Queue manager 

Print/Batch Services, 9-2, 9-3 
Queue names 

Print/Batch Services, 9-3 
Queue priorities 

Print/Batch Services, 9-5 
/QUEUE qualifier 

PRINT command, 9-31 
/QUEUE-queue-name qualifier 
SUBMIT command, 9-59 
Queues 

starting, 9-5 
stopping, 9-5 
Queue types 

Print/Batch Services, 9-3 
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/QUOTA qualifier 

MOUNT command, 15-16 
Quotas 
Disk, 5-1 

dynamic regions, 5-4 
Job, 5-1 
message, 5-4 

RIB (Receiver ID Block), 5-4 
send/receive, 5-1 

R_ 

Random data caching, 11-8 
RC25 

stopping, 14-2 
RDMEM privilege 

memory mapping, 6-4 
read memory, 6-4 
RDNFS privilege 

nonfile-structured I/O, 6-5 
RDS (RSTS/E Disk Structure) 
levels, 1-4 
SYSTAT, 1-^1 
Read access 

GREAD privilege, 6-3 
WREAD privilege, 6-7 
READY state 

processing entries, 9-6 
/READ_ONLY qualifier 

INSTALL/LIBRARY command, 12-26 
INSTALL/RUNTIME_SYSTEM command, 12-29 
Rebuilding dirty disks with MOUNT, 15-16 
/REBUILD qualifier 

MOUNT command, 15-16 
/RECALL qualifier 

SET TERMINAL command, 8-33 
Receiver identification, A-24 
RECOVR.COM file, 16-2 
/REGIS qualifier 

SET TERMINAL command, 8-33 
/RELEASE qualifier 

SET ENTRY command, 9-35 
SET JOB command, 13-18 
SET SYSTEM command, 14-32 
Remote line, controlling, 13-7 
Remote terminal test 

KBEXER program, F-12 
/REMOTE_PORT qualifier 

ASSIGN/PORT command, 8-13 
CREATE/PORT command, 8-15 
SET PORT command, 8-24 
REMOVE/ERROR_FILE command, 12-18, 12-32 
/LOG qualifier, 12-32 
REMOVE/JOB command, 13-16 
/CONFIRM qualifier, 13-16 
example, 13-4 
/query qualifier, 13-16 
REMOVE/LIBRARY command, 12-33 
REMOVE/OVERLAY_FILE command, 12-18, 12-34 
REMOVE/RUNTIME_SYSTEM command, 12-5, 
12-35 

REMOVE/SWAP_FILE command, 12-16, 12-36 
/LOG qualifier, 12-36 
Rename access 

GWRITE privilege, 6-3 
WWRITE privilege, 6-8 


REORDR 

account designators, 11-4 
dialogue, 11-3 

questions, 11—3t 

directory restructuring functions, 11-2 

error messages, 11-5 

example, 11-6 

fatal errors, 11-6 

messages, 11 —6t 

precautions on use, 11-5 

processing messages, 11-5 

restructure directories, 11-2 

run, 11-3 

/REPLACE qualifier 

ASSIGN/SYSTEM command, 12-19 
BACKUP/COPY command, 15-17 
BACKUP/IMAGE command, 16-26 
DEFINE/COMMAND/SYSTEM command, 12-21 
RESTORE command, 16-2,16-34 
REPLY command, 17-6 
/ABORT qualifier, 17-6 
/ANSWER qualifier, 17-6 
/PENDING qualifier, 17-6 
/PROMPT qualifier, 17-6 
/TO qualifier, 17-6 
/REPLY qualifier 

SHOW REQUESTS command, 17-11 
REQUE command 
SPOOL, A-35 
/RESET qualifier 

DELETE/ACCOUNT command, 7-10 
SET TERMINAL command, 8-^33 
SHOW ACCOUNT command, 7-19 
Resident libraries, 12-7 

DISPLY program status, 14-23 
permanently resident, 12-8 
remove, 12-8 
Resident library 
removing 

under SHUTUP, 4-10 
RMS, 11-10 
XBUF allocation, 11-10 
RESTART command 
SPOOL, A-35 
/RESTART qualifier 

START/QUEUE/MANAGER command, 9-54 
RESTOR 

attached to a terminal, A-47 
commands through OPSER, A-47t 
running detached, A-5, A-47 
RESTORE, E-3t 
aborting, E-21 
bad blocks, E-8 
dialogue questions, E-IOt 
example, E-11 to E-13 
output used for system disk, E-10 
relocation of blocks, E-9 
restoring a RSTS/E disk, E-8 
run statistics, E-23 
SAVE Set format, E-1 

RESTORE/DIRECTORY command, 16-36 to 17-1 
/ASSIST qualifier, 16-37 
/BRIEF qualifier, 16-37 
/BUFFER_SIZE qualifier, 16-37 
/CREATED qualifier, 16-37 
/END qualifier, 16-38 
/EXCLUDE qualifier, 16-38 
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RESTORE/DIRECTORY command (Cont.) 
/FULL qualifier, 16-38 
/INCLUDE qualifier, 16-38 
/IN_LABEL qualifier, 16-38 
/LIST_FILE qualifier, 16-38 
/MODIFIED qualifier, 16-37 
/OCCURRENCE qualifier, 16-39 
/OUTPUT qualifier, 16-39 
/PROMPT qualifier, 16-39 
/REWIND qualifier, 16-39 
/SELECT qualifier, 16-39 
RESTORE command, 16-28 to 16-35 
/ACCOUNT_DATA qualifier, 16-30 
/ASSIST qualifier, 16-30 
/BUFFER_SIZE qualifier, 16-30 
/CREATED qualifier, 16-30 
/END qualifier, 16-31 
/EXCLUDE qualifier, 16-31 
/FILEJDATA qualifier, 16-31 
/INCLUDE qualifier, 16-31 
/INITIALIZE qualifier, 16-31,16-32 
/IN_LABEL qualifier, 16-32 
/MODIFIED qualifier, 16-30 
/OCCURRENCE qualifier, 16-32 
/OPTIMIZE qualifier, 16-32 
/OUTPUT qualifier, 16-33 
/OUT_LABEL qualifier, 16-32 
/PLACED_POSITION qualifier, 16-33 
/PROMPT qualifier, 16-33 
/QUERY qualifier, 16-33 
/REPLACE qualifier, 16-34 
restrictions, 16-28 
/REWIND qualifier, 16-34 
/SELECT qualifier, 16-34 
system recovery, 16-2 
/VERIFY qualifier, 16-34 
Restricted device 

DEVICE privilege, 6-3 
Restricted receiver 
SEND privilege, 6-5 
Restrictions 

Backup sets, 16-5 
RESTORE command, 16-28 
/RESTRICT qualifier 

MOUNT command, 15-17 
SET DEVICE command, 11-22 
SET TERMINAL command, 8-33 
/RESUME qualifier 

SET TERMINAL command, 8-33 
/RETAIN qualifier 

INITIALIZE command, 15-11 
Retrieval pointers 

information for data blocks, 11-2 
RETYPE command, OPSER, A-10 
/REWIND qualifier 

BACKUP/DIRECTORY command, 16-21 
BACKUP command, 16-10 
RESTORE/DIRECTORY command, 16-39 
RESTORE command, 16-34 
RIB (Receiver ID Block), 6-4 
quota, 5-4 
/RIB_QUOTA qualifier 

CREATE/ACCOUNT command, 7-8 
SET ACCOUNT command, 7-14 
Ring characteristics, 8-1 
RJ2780 program 

communication paths, A-5 


RJ2780 program (Cont.) 
shutdown, A-6 

RMS (Record Management System) 
caching files, 11-10 
indexed file bucket sizes, 11-11 
resident library, 11-10 
RSTS/E 

bootstrapping after system halt, 2-2 
bootstrapping procedures, 2-1 
disk structures, 1-3 
file structure, 1-4 
halting, 2-1 
initialization code, 2-1 
initialization options, 2-1 
management, 1-2 
monitor error detection, 10-1 
run-time systems, 12-2 
shutdown procedures, 4-1 
starting up, 2-1 
RSTS/E Error Package 

use with DEVTST package, F-1 
RSTS/E Privileges, 6-2t 
RSX, keyboard monitor, 1-2 
RT11, keyboard monitor, 1-2 
Run burst 

decrease, A-32 
default value, 13-6 
definition, 13-6 
raise on SPOOL, A-32 
set, 13-5 

system operation, 13-6 
/RUNBURST switch 
QUEMAN, A-16t 
RUN command 

how system treats, 12-5 
no file type specified, 12-5 
Run-time system, 1-2 
auxiliary, 12-3, 12-4 
BASIC-PLUS, 12-3 
change default file type, 12-6 
control, 12-2, 12-3 
DCL command, 12-4 
definition, 12-2 
description block, 12-4 
DISPLY report, 14-21 
installing, 3-9 
language interface, 12-2 
loading a, 12-5 
permanently resident, 12-6 
placement of, 12-5 
position of primary, 12-5 
primary, 12-3 
removing 

auxiliary, 12-4 
from system, 12-6 
under SHUTUP, 4-10 
.RTS file type, 12-3 
specifying load address, 12-4 
storage of, 12-3 
temporarily resident, 12-6 
use, 12-2 

/RUNTIME_SYSTEM qualifier 
SET FILE command, 12-38 
/RUN_BURST=n qualifier 

START/OPERATOR_SERVICES command, 17-14 
/RUN_BURST qualifier 

INITIALIZE/SERVER command, 9-29 
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/RUN_BURST qualifier (Cont.) 

SET JOB command, 13-18 
SET SERVER command, 9-42 
START/QUEUE/MANAGER command, 9-52 

S 

SAV/RES 

full function command line, E-18 
SAV/RES FUNCTION 
prompt, E-2, E-3 
SAVE 

run statistics, E-23 
SAVE Set 

default name, E-2 

dismount message, E-20 

extract label information from, E-17t 

format, E-1, E-8 

identify, E-2 

magnetic tape, E-19 

magnetic tape density, E-20 

processing multivolume, E-20 

recreate disk, E-8 

volume 

booting RSTS/E, E-19t 
by-pass label checking, E-6 
SAVRES, E-1 
SAVRES 
bad blocks 

output device, E-24 
processing, E-24 

changes caused by bad blocks, E-24 
checking 

input volume, E-7 
comparison with BACKUP, E-1 
create bootable medium, E-18 
Ctrl/C in dialogue, E-5, E-21 
Ctrl/Z in dialogue, E-5 
definition of terms, E-1 
device specification switches, E-6t 
dialogue, E-3 
defaults, E-5 
disks, like, E-2 
dismounting volumes, E-20 
dismount message, E-20 
errors, E-3 

dialogue, E-24 
handling, E-24 
messages, E-25t 
transfer phase, E-24 
verification phase, E-24 
/ERROR switch, E-4, E-5t 
exit, E-3 

fatal transfer errors, E-28 
full function command line, E-4 
function response, E-3 
functions, E-1, E-3t 
IDENTIFY 

dialogue, E-17t 
example, E-17 
IMAGE 

dialogue, E-13t 
example, E-15 to E-16 
function, E-13 
input volume errors, E-7t 
message types, E-3 
mounting volumes, E-20 


SAVRES (Cont.) 

/NOERROR switch, E-5t, E-24, E-28 

nonfatal transfer errors, E-28, E-29t 

nonselective backup, E-1 

/NOSTATS switch, E-5t 

/NOVERIFY switch, E-4, E-5t 

operator intervention during processing, E-19 

prompt, E-3 

reaccessing devices, E-21 
RESTORE 

dialogue questions, E-10 
example, E—11 to E-13 
output as system disk, E-10 
processing, E-2 
restore archived sets, E-1 
RESTORE function, E-8, E-9 
run, E-2 

off line, E-2 
on line, E-2 
SAVE set, E-1 
SAVE Set 

name, E-2 
volume, E-1 
/STATS, E-5t 
/STATS switch, E-4 
summary information, E-4 
summary report, E-22 
format, E-22f 
totals, E-23t 
switch types, E-4 
transfer errors, E-28 
use, E-1 

/VERIFY switch, E-4, E-5t 
volume label checking, E-18 
/SCOPE qualifier 

SET TERMINAL command, 8-^33 
/SCRATCH switch 
SAVRES, E-6 
/SEIZE qualifier 

ALLOCATE command, 11-13 
/SELECT qualifier 

BACKUP/DIRECTORY command, 16-21 
RESTORE/DIRECTORY command, 1S-39 
RESTORE command, 16-34 
/SELECT_ERASE qualifier 

SET TERMINAL command, 8-34 
Send/receive quotas, 5-4 
message, 5-4 

RIB (Receiver ID Block), 5-4 
Send/Receive quotas, 5-1 
SEND privilege 

BROADCAST command, 6-5 
restricted receiver, 6-5 
Sequential data caching, 11-8,11-9 
example, 11-9 
Serial printers 

using with PBS, 9-11 
Servers 

assigned to queues, 9-4 
/SERVICE qualifier 

ASSIGN/PORT command, 8-13 
CREATE/PORT command, 8-15 
SET PORT command, 8-24 
SET ACCOUNT command, 7-12 
/CAPTIVE qualifier, 7-13 
/DETACHED_JOB_QUOTA qualifier, 7-13 
/DIALUP qualifier, 7-13 








SET ACCOUNT command (Cont.) 

/EXPIRE qualifier, 7-13 
/INTERACTIVE qualifier, 7-13 
/IN_QUOTA qualifier, 7-13 
/JOB_QUOTA qualifier, 7-13 
/LOG qualifier, 7-13 
/LOOKUP qualifier, 7-13 
/MESSAGE_QUOTA qualifier, 7-13 
/NAME qualifier, 7-13 
/NETWORK qualifier, 7-13 
/OUT_QUOTA qualifier, 7-13 
/PASSWORD_PROMPT qualifier, 7-14 
/PRIVILEGE qualifier, 7-14 
/RIB_QUOTA qualifier, 7-14 
/USER qualifier, 7-14 
SET CACHE command 
/ALL qualifier, 11-18 
/CLUSTERSIZE qualifier, 11-19 
/DATA_MAXIMUM qualifier, 11-19 
/DIRECTORY_MAXIMUM qualifier, 11-19 
/DISABLE qualifier, 11-20 
/FILE qualifier, 11-18 
/KEEP qualifier, 11-20 
/MAXIMUM qualifier, 11-19 
/NOFILE qualifier, 11-18 
qualifiers, 11-18 
TUNE privilege, 11-18 
SET DATE command, 14-3, 14-29 
SET DEVICE command 

/DISABLE qualifier, 11-1,11-22 
/ENABLE qualifier, 11-1,11-22 
/NORESTRICT qualifier, 11-1 
/RESTRICT qualifier, 11-1,11-22 
SET ENTRY command, 9-35 

/AFTER=date:time qualifier, 9-35 
/ALL qualifier, 9-35 
/BATCH qualifier, 9-^35 
/CPU_LIMIT=n qualifier, 9-35 
/FORMS=form-name qualifier, 9-35 
/HOLD qualifier, 9-35 
/JOB_COUNT=n qualifier, 9-35 
/PAGE_LIMIT=n qualifier, 9-35 
/PRIORITY=n qualifier, 9-^35 
/RELEASE qualifier, 9-35 
/TIME_LIMIT=n qualifier, 9-35 
SET ENTRY Command, 9-35 

SET FILE/RUNTIME_SYSTEM=name command, 12-6 
SET FILE command, 12-37 
/CACHE qualifier, 12-37 
/DELETABLE qualifier, 12-38 
/IGNORE qualifier, 12-38 
/LOG qualifier, 12-38 
/NONCONTIGUOUS qualifier, 12-38 
/PLACED qualifier, 12-38 
/PROTECTION qualifier, 12-38 
/RUNTIME_SYSTEM qualifier, 12-38 
SET JOB/HOLD command, 13-5 
SET JOB/RELEASE, 13-5 
SET JOB/PRIORITY command, 13-6 
SET JOB/RUN_BURST command, 13-6 
SET JOB/SIZE command, 13-7 
SET JOB command, 13-17 
/HOLD qualifier, 13-17 
/KEYBOARD_MONITOR qualifier, 13-17 
/PRIORITY qualifier, 13-17 
/PRIVILEGE qualifier, 13-18 
/RELEASE qualifier, 13-18 


SET JOB command (Cont.) 

/RUN_BURST qualifier, 13-18 
/SIZE qualifier, 13-18 
SET NODE/LAT command, 8-21 
/ACCESS qualifier, 8-21 
/DISABLE qualifier, 8-21 
/ENABLE qualifier, 8-22 
/IDENTIFICATION qualifier, 8-22 
/LOG qualifier, 8-22 
/MULTICAST_TIMER qualifier, 8-22 
SET OPERATOR_SERVICES command, 17-8 
SETPAS privilege 

SET PASSWORD command, 6-5 
SET PASSWORD command, 7-15 
/LOG qualifier, 7-16 
SETPAS privilege, 6-5 
/SYSTEM qualifier, 7-16 
SET PORT command, 8-23 
/LAT qualifier, 8-23 
/LOG qualifier, 8-23 
/QUEUED qualifier, 8-23 
/REMOTE_PORT qualifier, 8-24 
/SERVICE qualifier, 8-24 
SET PRINTER command 

/BACKSPACE qualifier, 11-23 
/CONTROLS qualifier, 11-24 
/CR_PREFIX qualifier, 11-24 
/DEVICE_TYPE qualifier, 11-24 
/EIGHT_BIT qualifier, 11-24 
/EOT qualifier, 11-24 
/FILL qualifier, 11-24 
/OMIT_CR qualifier, 11-24 
/PAGE_LENGTH qualifier, 11-24 
/SPECIAL_CHARACTER qualifier, 11-24 
/TAB qualifier, 11-25 
/UPPERCASE qualifier, 11-25 
/WIDTH qualifier, 11-25 
SET PRIVILEGE command, 6-1 
SET QUEUE command, 9-38 
/ALL qualifier, 9-38 
/BATCH qualifier, 9-39 
/CPUJJMIT qualifier, 9-^39 
/DEFAULT qualifier, 9-39 
/FORMS qualifier, 9-39 
/PAGEJJMIT qualifier, 9-^39 
/PRINT qualifier, 9-40 
/PRIORITY qualifier, 9-40 
/PRIVILEGES qualifier, 9-40 
/TIME-LIMIT qualifier, 9-40 
SET SERVER command, 9-41 
/BATCH qualifier, 9-41 
/CONTROLS qualifier, 9-41 
/FORMS qualifier, 9-42 
/PRINT qualifier, 9-42 
/PRIORITY qualifier, 9-42 
/RUN_BURST qualifier, 9-42 
/SHAREABLE qualifier, 9-42 
SET SERVICE/LAT command, 8-25 
/IDENTIFICATION qualifier, 8-25 
/LOG qualifier, 8-25 
/STATIC_RATNG qualifier, 8-25 
SET SYSTEM/ANSWERBACK command, 14-24 
SET SYSTEM/DYN AM IC_R EG ION JJM IT command, 
5-4 

SET SYSTEM/EMT_LOGGING command, 14-8, 
14-31 

SET SYSTEM/HOLD command, 14-2 
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SET SYSTEM/LOGINS command, 12-16, 13-1, 13-2 
SET SYSTEM/MONITOR_NAME command, 2-S 
SET SYSTEM/NOLOGINS command, 13-1 
SET SYSTEM/RELEASE command, 14-2 
SET SYSTEM command, 8-26, 13-19, 14-30 
/ANSWERBACK qualifier, 14-30 
/DATE_FORMAT qualifier, 14-31 
/DENSITY qualifier, 14-31 
/DYNAMIC_REGION_LIMIT qualifier, 14-31 
/FMS qualifier, 14-31 
/HANGUP qualifier, 14-31 
/HOLD qualifier, 14-31 
/LABEL qualifier, 14-32 
/LAT qualifier, S-26, 14-32 
/LOGINS qualifier, 13-19,14-32 
/LOG qualifier, 14-32 
/MONITOR_NAME qualifier, 14-32 
/NAME qualifier, 14-32 
/PASSWORD_PROMPT qualifier, 14-82 
/POWERFAIL_DELAY qualifier, 14-82 
/PSEUDO_KEYBOARDS qualifier, 8-26, 14-82 
/RELEASE qualifier, 14-32 
/STATISTICS qualifier, 14-33 
/SWAP_MAXIMUM qualifier, 14-33 
/TIME_FORMAT qualifier, 14-33 
SET TERMINAL/ANSWERBACK/PERMANENT 
command, 14-24 

SET TERMINALVOPERATOR_SERVICES command, 
17-9 

SET TERMINAL command, 8-27 
/ADVANCED_VIDEO qualifier, 8-28 
/ALT_MODE qualifier, 8-28 
/ANSI qualifier, 8-28 
/ANSWERBACK qualifier, 8-29 
/AUTOBAUD qualifier, 8-1, 8-29 
/BREAK qualifier, 8-29 
/BROADCAST qualifier, 8-6, 8-29 
/BUFFER_QUOTA qualifier, 8-29 
/132_COLUMNS qualifier, 8-28 
/CONTROL qualifier, 8-29 
/CRFILL qualifier, 8-30 
/DELIMITER qualifier, 8-30 
/DEVICEJTYPE qualifier, 8-30 
dialup lines, 8-1 
/DIALUP qualifier, 8-30 
/EIGHT_BIT qualifier, 8-30 
/ESCAPE__SEQUENCE qualifier, 8-80 
/FORMFEED qualifier, 8-30 
/HARDCOPY qualifier, 8-31 
/HOSTSYNC qualifier, 8-31 
HWCFG privilege, 8-3 
/INQUIRE, 8-11 
/INQUIRE qualifier, 8-31 
/INSERT qualifier, 8-31 
/INTERACTIVE qualifier, 8-^31 
/KATAKANA qualifier, 8-31 
/LINE_EDITING qualifier, 8-32 
/LOADABLE_CHARACTERS qualifier, 8-32 
/LOCAL_ECHO qualifier, 8-32 
/LOWERCASE qualifier, 8-32 
/NOBROADCAST qualifier, 8-6 
/OPERATOR_SERVICES qualifier, 8-32, 17-9 
/OVERSTRIKE qualifier, 8-32 
/PARITY qualifier, 8-32 
/PERMANENT qualifier, 8-5, 8-33 
/PRINTER_PORT qualifier, 8-33 
/RECALL qualifier, 8-33 


SET TERMINAL command (Cont.) 

/REGIS qualifier, 8-33 
/RESET qualifier, 8-33 
/RESTRICT qualifier, 8-33 
/RESUME qualifier, 8-33 
/SCOPE qualifier, 8-33 
/SELECT_ERASE qualifier, 8-34 
/SETUP qualifier, 8-34 
/SIXEL qualifier, 8-34 
/SPEED qualifier, 8-34 
STABT.COM, 8-1, 8-5 
/TAB qualifier, 8-34 
/TTSYNC qualifier, 8-34 
/TYPE qualifier, 8-35 
/UPPERCASE qualifier, 8-35 
/UP_ARROW qualifier, 8-35 
/USER_DEFINED_KEYS qualifier, 8^35 
/WIDTH qualifier, 8-35 
SET TIME command, 14-3, 14-34 
Setting job priority, 13-5 
Setting job size, 13-5 
/SETUP qualifier 

SET TERMINAL command, 8-34 
/SHAREABLE qualifier 

INITIALIZE/SERVER command, 9-29 
INSTALL/LIBRARY command, 12-26 
INSTALL/RUNTIME_SYSTEM command, 12-29 
MOUNT command, 15-18 
SET SERVER command, 9-42 
SHOW/PORT command 
/ALL qualifier, 8-40 
/APPLICATION qualifier, 8-40 
/INTERACTIVE qualifier, 8-^tO 
/LAT qualifier, 8-40 
/OUTPUT qualifier, 8-40 
SHOW ACCOUNT command, 7-17 
/ACCOUNTING_DATA qualifier, 7-18 
/ALL qualifier, 7-18 
/BRIEF qualifier, 7-19 
/FULL qualifier, 7-19 
/OUTPUT qualifier, 7-19 
/RESTE qualifier, 7-19 
sample output, 7-17 
/USER qualifier, 7-19 

SHOW BUFFERS command, buffer status report, 
12-16 

SHOW CACHE command, 11-26 
/OUTPUT qualifier, 11-27 
SHOW COMMAND/SYSTEM command, 12-13, 
12-39 

/ALL qualifier, 12-39 
/OUTPUT qualifier, 12-39 
SHOW COUNTERS/LAT command, 8-36 
/DEVICE qualifier, 8-37 
/NODE qualifier, 8-37 
/OUTPUT qualifier, 8-37 
/TERMINAL_SERVERS qualifier, 8-37 
/ZERO qualifier, 8-37 
SHOW DEVICE command, 11-28 
/ALLOCATED qualifier, 11-28 
/ALL qualifier, 11-28 
/OUTPUT qualifier, 11-28 
SHOW DEVICES/ALLOCATED 
use for shutdown, 4-1 
SHOW DISKS 

use for shutdown, 4-1 
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SHOW DISKS command 
free space, 14-11 
/OUTPUT qualifier, 11-29 
SHOW ENTRY command, 9-^3 
/ALL qualifier, 9-43 
/BATCH qualifier, 9-43 
/BRIEF qualifier, 9-43 
/FILES qualifier, 9-43 
/FULL qualifier, 9-43 
/OUTPUT qualifier, 9-43 
/PRINT qualifier, 9-43 
/STATUS qualifier, $-43 
SHOW FILE/SYSTEM command, 12-40 
/ALL qualifier, 12-40 
/ERROR_FILE qualifier, 12-^0 
/NETWORK_FILE qualifier, 12—40 
/OUTPUT qualifier, 12-40 
/OVERLAY_FILE qualifier, 12-40 
/SWAP_FILE qualifier, 12-40 
SHOW JOB/PRIVILEGE command, 13-20 
/OUTPUT qualifier, 13-20 
SHOW JOBS 

use for shutdown, 4-1 
SHOW JOBS/DETACHED command, 14-11 
SHOW JOBS command 
job status, 14-11 

SHOW LIBRARY/SYSTEM command 
/OUTPUT qualifier, 12-41 
SHOW LIBRARY command, 12—41 
SHOW LOGICALS command, 12-11, 12-42 
/ALL qualifier, 12-42 
/OUTPUT qualifier, 12-42 
/SYSTEM qualifier, 12-42 
/USER qualifier, 12-42 
SHOW NODE/LAT command, 8-38 
/OUTPUT qualifier, 8-38 

SHOW OPERATOR_SERVICES command, 17-10 
/OUTPUT qualifier, 17-10 
SHOW PORT command, 8-39 
SHOW PRINTER command 
/ALL qualifier, 11-30 
/OUTPUT qualifier, 11-30 
SHOW QUEUE command, 9-46 
/ALL qualifier, 9-46 
/BATCH qualifier, 9-46 
/BRIEF qualifier, £-46 
/FULL qualifier, 9-46 
/OUTPUT qualifier, 9-^6 
/PRINT qualifier, 9-46 
SHOW REQUESTS command, 17-11 
/ALL qualifier, 17-11 
/BEFORE=date-time qualifier, 17-11 
/BRIEF qualifier, 17-11 
/EXACT qualifier, 17-11 
/FACILITY=(facility-list) qualifier, 17-11 
/FULL qualifier, 17-11 
/INPUT=file-spec qualifier, 17-11 
/JOB=n qualifier, 17-11 
/OUTPUT qualifier, 17-11 
/REPLY qualifier, 17-11 
/SINCE=date-time qualifier, 17-11 
/TERMINAL=device qualifier, 17-11 
/TEXT qualifier, 17-11 
/USER qualifier, 17-11 

SHOW RUNTIME_SYSTEM command, 12-44 
/OUTPUT qualifier, 12-44 
SHOW SERVER command, 9-48 


SHOW SERVER command (Cont.) 

/ALL qualifier, 9-48 
/BATCH qualifier, £-48 
/BRIEF qualifier, 9-48 
/FULL qualifier, 9-49 
/OUTPUT qualifier, 9-49 
/PRINT qualifier, 9-49 
SHOW SERVICE/LAT command, 8-41 
/OUTPUT qualifier, 8-41 
SHOW SESSIONS command, 8-42 
/DEVICE qualifier, 8-42 
/LAT qualifier, 8-43 
/OUTPUT qualifier, 8-43 

SHOW SYSTEM/EMT_LOGGING command, 14-8 
SHOW SYSTEM command, 14-11, 14-35 
/EMT_LOGGING qualifier, 14-35 
monitor name, 2-6 
/OUTPUT qualifier, 14-35 
swap size, 2-6 

SHOW TERMINAL command, 8-6, 8-44 
/ALL qualifier, 8-45 
/BRIEF qualifier, 8—45 
/FULL qualifier, 8-45 
/OUTPUT qualifier, 8-45 
/PERMANENT qualifier, 8-45 
sample output, 8-44 

SHOW TERMINAL_SERVERS/LAT command, 8-46 
/OUTPUT qualifier, 8-46 
SHOW USERS command 
job control, 13-4 
job status, 14-11 
Shutdown 

disabling DECnet/E during, 4—4 
ERRCPY, 4-9 
EVTLOG program, 4-9 
final, under SHUTUP, 4-11 
formula for waiting period, 4-5 
manual procedure, A-45 
normal (example), 4-11 
OMS, 4-8 
OPSER, 4-8, A-5 
PBS, 4-7 

performing system, 4-1 
RSTS/E system, 4-1 
specify waiting period, 4-3 
SHUTUP 

attached jobs, 4-6 

automatic restart, 4-4 

communicate with OPSER, 4-2 

detached jobs, 4-6 

disable DECnet/E, 4-4 

disabling logins, 4-4 

disk dismount phase, 4-10 

EMT logging shutdown phase, 4-10 

ERRCPY shutdown phase, 4-9 

error message to ERRCPY, 10-3 

example 

DECnet/E shutdown, 4-13 
final job killing phase, 4-10 
final shutdown phase, 4-11 
formula for waiting period, 4-5 
initial job killing phase, 4-6 
limit logins, 4-4 
limit network activity, 4-4 
OMS shutdown phase, 4-8 
operational phases, 4—3 
OPSER shutdown phase, 4-8 


lndex-24 









SHUTUP (Cont.) 

PBS shutdown phase, 4-7 
perform shutdown with, 4-1 
phases of, 4-2 

removing swapping files, 12-16 
resident library removal phase, 4-10 
run from console terminal, 4-2 
running QUEMAN after, A-20 
run-time system removal phase, 4-10 
run with OPSER, 4-3 
run without OPSER, 4-3 
set up dialogue phase, 4-2 
shutdown of DECnet/E, 4-4 
specify shutdown wait period, 4-3 
swap file removal phase, 4-10 
system recovery, 16-2 
terminating OPSER, A-5, A-45 
treatment of PBS, 4-6 
unexpected errors, 4—10 
use of, 2-3 

warning message, 4—5 
SHUTUP example 

large RSTS/E system, 4-11 
small RSTS/E system, 4-12 
SHUTUP privilege 
system control, 6-5 
SIL (Save Image Library) 
format, 12-7 
MAKSIL program, 12-7 
Simulation of hardware errors 
device testing package, F-1 
/SINCE=date-time qualifier 

SHOW REQUESTS command, 17-11 
/SIXEL qualifier 

SET TERMINAL command, 8-34 
/SIZE qualifier 

CREATE/ACCOUNT command, 7-8 
INSTALL/ERROR_FILE command, 12-24 
INSTALL;OVERLAY_FILE command, 12-27 
INSTALLySWAP_FILE command, 12-31 
SET JOB command, 13-18 
Small buffers 

DISPLY report, 14-21 
general (SYSTAT), 14-11 
SHOW BUFFERS command, 14-11 
Software errors 
logging, 10-1 

/SPECIAL_CHARACTER qualifier 
SET PRINTER command, 11-24 
/SPEED qualifier 

SET TERMINAL command, 8-34 
SPOOL, A-1 

ABORT command, A-26, A-35 
/ALIGN switch, A-37 
ASSIGN option, A-24 
changing NORMAL form, A-24 
compiled version of, A-21 
default form, A-24 
default keyboard values, A-28 
default line printer values, A-27 
/DFLENGTH switch, A-25 
error handling, A-34 
error messages, A-36 
error text in user output, A-36t 
file header, A-35 
FORM command, A-37 
FORM option, A-24 


SPOOL (Cont.) 

forms control characters, A-25 
interrupt commands, A-30, A-30t 
job header, A-35 
line printer errors, A-34 
logical device name, A-22 
modules, A-21 
NAME option, A-24 
NORMAL option, A-24 
/PAGE_EJECT switch, A-25 
PHYSICAL option, A-24 
QUE command, A-35 
raise priority, A-32 
raise run burst, A-32 
REQUE command, A-35 
RESTART command, A-35 
restart queued request, A-35 
run, A-21 
startup 

error processing, A-28 
examples, A-31 
options, A—23t 

syntax error messages, A-28, A-29t 
terminate 

queued request, A-35 
without shutting down, A-45 
Spooling 

determining number of jobs, A-18 
initial conditions for, queues, A-14 
keyboard, A-28 
line printer, A-27 
Spooling Package Library, A-21 
Spooling programs 
commands, A-12 
controlling, A-12 
line printer, A-21 
messages, A-12 
monitoring, A-12 
SPOOL, A-21 
SPOOL and BATCH, A-1 
table of in QUEMAN, A-4 
START.COM 

automatic restart, 2-4 
memory image, 2-5 
sample, 3-2 

SET TERMINAL command, 8-1,8-5 
START.COM file 
ANALYS, 10-25 

commands auxiliary run-time system, 12-3 
contents, 3-1 
logical names, 12-9 
replace, 3-1 

START/LAT command, 8-47 
/LOG qualifier, 8-47 

START/OPERATOR_SERVICES command, 17-14 
/KEEP qualifier, 17-14 
/PRIORITY=n qualifier, 17-14 
/RUN_BURST=n qualifier, 17-14 
START/QUEUE/MANAGER command, 9-51 
/PRIORITY qualifier, 9-52 
/RUN_BURST qualifier, 9-52 
START/QUEUE command, 9-50 
START/SERVER command, 9-53 
/BACKSPACE qualifier, 0-53 
/FORWARDSPACE qualifier, 9-53 
/NEXT_JOB qualifier, 9-54 
/PAGE qualifier, 9-54 
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START/SERVER command (Cont.) 

/RESTART qualifier, 9-54 
/TOP_OF_FILE qualifier, 9-54 
Startup 

BATCH options, A-39t 
BATCH procedures, A-41 
CCL command definitions, 3-10 
controlling system, 3-1 
OMS, 17-5 
SPOOL options, A-23t 
terminal characteristics, 3-9 
Startup control file 

order of operations, 3-2 
/STATIC_RATING qualifier 

CREATE/SERVICE/LAT command, 6-17 
SET SERVICE/LAT command, 8-25 
Statistics 

abbreviations in DISPLY report, 14-17 
busy device, 14-19 
job status, 14-17 
SAVRES run total, E-23t 
STATUS command 
QUEMAN, A-18 
/STATUS qualifier 

SHOW ENTRY command, 9-43 
STOP/LAT commanad 
/LOG qualifier, 8-48 
STOP/LAT command, 8-48 
STOP/OPERATOR_SERVICES command, 17-15 
/ABORT qualifier, 17-15 
STOP/QUEUE/MANAGER command, 9-56 
/ABORT qualifier, 9-56 
STOP/QUEUE command, 9-55 
STOP/SERVER command, 9-57 
/FILEJEND qualifier, 9-58 
/JOB_END qualifier, 9-58 
/PAGE_END qualifier, 9-58 
Stop bit settings, 8-7 
Stopping OMS, 17-6 
SUBMIT command, 9-59 

/AFTER=date:time qualifier, 9-59 
/CPU_LIMIT=n qualifier, 9-59 
/DELETE qualifier, 9-59 
/HOLD qualifier, 9-59 
/LOG_DELETE qualifier, 9-59 
/LOG_FILE=file-spec qualifier, 9-59 
/LOG_QUEUE=queue-name qualifier, 9-59 
/NAME=entry-name qualifier, 9-59 
/NOTIFY qualifier, 9-59 
/OWNER=ppn qualifier, 9-59 
/PARAMETERS=(parameter,...) qualifier, 9-59 
/PRIORITY=n qualifier, 9-59 
/QUEUE=queue-name qualifier, 9-59 
/TIME_LIMIT=n qualifier, 9-59 
Summary report 
ERRDIS, 10—6 
run totals, E-23t 
SWAPO.SYS file 

allocate and position, 12-14 
SWAP1 .SYS file 

allocate and position, 12-14 
SWAP3.SYS file 

allocate and position, 12-14 
Swap file, 1-12 
add, 12-15 
affects logins, 12-16 
online creation, 12-15 


Swap file (Cont.) 

removing, 12-15, 12-16 

under SHUTUP, 4-10, 12-16 
SHOW FILE/SYSTEM command, 12-17 
Swapping, 1-12 
Swapping mode 

TUNE privilege, 6-7 
Swap space, 13-2 

restricting logins, 12-16 
/SWAP_FILE qualifier 

SHOW FILE/SYSTEM command, 12-40 
/SWAP_MAXIMUM qualifier 

SET SYSTEM command, 14-33 
SWCFG privilege 

system manager function, 6-5 
SWCTL privilege 

EMT logging, 14-8,14-31 
Logins, 6-5 

Network management, 6-5 
SWITCH program 

change keyboard monitor, 1-1 
SYO: 

system disk, 1-2 
SYS functions 

programming, 2-5 
SYS 10 privilege 
file access, 6-6 
write access, 6-8 
SYSMOD privilege 

system modification, 6-6 
SYSTAT 

free disk space, 14-11 
guidelines, 14-10 
use, 14—10 
System 

automatic restart RSTS/E, 2-2 
commands, 1-11 

EMT logging to record activities, 14-4 
enable data caching, 11-18 
enable directory caching, 11-18 
halt, after bootstrapping RSTS/E, 2-2 
halting the RSTS/E, 2-3 
initialization options, 1-2 
initialized in restart mode, 2-5 
monitoring status, 14-11 
operational concepts, 1-11 
shutdown, 4-1 
startup, 3-1 

suspending operations, 14-2 
System clock 

DATES privilege, 6-3 
System commands 

INSTAL privilege, 6-4 
System control 

HWCTL privilege, 6-4 
JOBCTL privilege, 6-4 
SHUTUP privilege, 6-5 
System crash, 2-2 

ANALYS program, 3-11 
causes, 2—4 
handling, 2-5 
randomly occurring, 2-5 
System disk, 1-2 
access, 1-3 
contents, 1-3 
recovery, 16-2 
System error log, F-1 
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System Error Package 
programs, 10-1 
System errors 

compilation, 10-1 
extraction, 10-1 
formatting, 10-1 
retention, 10-1 
System files 

INSTAL privilege, 6-4 
managing with DCL commands, 12—It 
System logical names 
INSTAL privilege, 6-4 
System manager function 
HWCFG privilege, 6-3 
SWCFG privilege, 6-5 
System messages, 17-3 
System modification 

SYSMOD privilege, 6-6 
System programs, 1-2 
/SYSTEM qualifier 

CREATE/PORT command, 8-15 
SET PASSWORD command, 7-16 
SHOW LOGICALS command, 12-42 
System restart 

START.COM, 2-5 
System security 

EMT logging, 14-5 
System startup 

command file, 3-2 
conditions at, 3-1 
controlling, 3-1 
crash recovery, 3-11 

T _ 

/TAB qualifier 

SET PRINTER command, 11-25 
SET TERMINAL command, 8-34 
Tape handling, DCL commands, 15—It 
/TEMPLATE qualifier 

CREATE/ACCOUNT command, 7-8 
TERDFL.SYS 

terminal characteristics, 8-4 
TERMAC.SYS 

terminal characteristics, 8-4 
Terminal 

at system command level, 1-11 
/BROADCAST command qualifier, 8-6 
Ctrl/C typed at, 1-11 
/DFLENGTH switch effect, A-26 
distinction from line printer, A-27 
FORCE command, 13-3 
hardware top of form, A-28 
line speed characteristics file, 8-2 
/NOBROADCAST command qualifier, 8-6 
OSC, A—13 

setting characteristics, 8-1 
top of form capability, A-26 
/TERMINAL=device qualifier 

SHOW REQUESTS command, 17-11 
Terminal characteristics 
HWCFG privilege, 8-3 
Startup, 3-9 
TERDFL.SYS, 8-4 
TERMAC.SYS, 8-4 
Terminal device designator, 8-2 


Terminal line 

dialup lines, 8-1 
local, 8—1 

Terminal parity, 8-6 
/TERMINAL qualifier 

LOGIN command, 13-15 
Terminal servers, 3-11,8-8 
/TERMINAL_SERVER qualifier 
CREATE/PORT command, 8-16 
/TERMINAL_SERVERS qualifier 

SHOW COUNTERS/LAT command, 8-87 
TERSPD.SYS file 

account location, 8-2 
/AUTOBAUD qualifier, 8-2 
why create, 8-2 
/TEXT qualifier 

SHOW REQUESTS command, 17—11 
Timesharing, start, 2-3 
/TIME_FORMAT qualifier 

SET SYSTEM command, 14-33 
/TIME_LIMIT=n qualifier 

SET ENTRY command, 9-35 
SUBMIT command, 9-59 
/TIME_LIMIT qualifier 

INITIALIZE/QUEUE command, 9—26 
SET QUEUE command, 9-40 
TMPPRV privilege 
set privilege bit, 6-6 
/TOP_OF_FILE qualifier 

START/QUEUE/MANAGER command, 9-54 
/TO qualifier 

REPLY command, 17—6 
/TRUNCATE qualifier 
PRINT command, 9-31 
/TTSYNC qualifier 

SET TERMINAL command, 8-34 
TUNE privilege 

alter base priority, 6-7 
SET CACHE command, 11-18 
swapping mode, 6-7 
swap size, 2-6 
/TYPE qualifier 

INSTALL/RUNTIME_SYSTEM command, 12-29 
SET TERMINAL command, 8-35 

U 

UFD (User File Directory) 
and MFD in Level 0, 1—5f 
mark file for caching, 11-8 
reorder, 11-5 

with MFD and GFDs in Level 1, 1-6f 
UNLOAD/INDEX command, 14-36 
UNLOAD/LIBRARY command, 12-8,12-45 
UNLOAD/OVERLAY command, 14-37 
UNLOAD/RUNTIME SYSTEM command, 12—6, 

12—46 

/UNLOAD qualifier 

DISMOUNT command, 15-5 
INSTALL/LIBRARY command, 12-26 
INSTALL/RUNTIME_SYSTEM command, 12—29 
/UPPERCASE qualifier 

SET PRINTER command, 11-25 
SET TERMINAL command, 8-35 
/UP_ARROW qualifier 

SET TERMINAL command, 8-35 
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USER1-8 privileges 

User-defined privileges, 6-8 


X 


User account, 7-1 


XBUF 


User-defined privileges 
USER1-8 privileges, 6-8 


caching allocation, 11—7, 11-9, 11-10 
resident library allocation, 11-10 


User interface 

Print/Batch Services, 9-2 


Z 


User job 
area, 1-11 


Zeroing the ERRDIS log, 10-22 
/ZERO qualifier 


/USER qualifier 

CREATE/ACCOUNT command, 7-8 


SHOW COUNTERS/LAT command, 8-37 


CREATE/PORT command, 8-16 
DELETE/ACCOUNT command, 7-10 
SET ACCOUNT command, 7-14 
SHOW ACCOUNT command, 7-19 
SHOW LOGICALS command, 12-42 
SHOW REQUESTS command, 17-11 
/USER_DEFINED_KEYS qualifier 
SET TERMINAL command, 8-35 


V 


/VERIFY qualifier 

BACKUP/COPY command, 16-17 
BACKUP/IMAGE command, 16-26 
BACKUP command, 16-10 
RESTORE command, 16-34 
Virtual disks, 11-12 
Volumes 

dismounting SAVRES, E-20 
mounting SAVRES, E-20 


W 


WACNT privilege 

account management, 6-7 
/WIDTH qualifier 

SET PRINTER command, 11-25 
SET TERMINAL command, 8-35 
Window turning 
reducing, 11-11 
Work file 

OMS, 17-2 
OMS.SYS, 17-2 
OPSER stores, A-2 
/WRAP qualifier 

PRINT command, 9-31 
WREAD privilege 

execute access, 6-7 
read access, 6-7 
Write access 

GWRITE privilege, 6-8 
SYSIO privilege, 6-8 
WWRITE privilege, 6-8 
/WRITE qualifier 

INITIALIZE command, 15-11 
MOUNT command, 15-18,15-20 
WRTNFS privilege 

nonfile-structured I/O, 6-8 
WWRITE privilege 
create access, 6-8 
rename access, 6-8 
write access, 6-8 
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How to Order Additional Documentation 


Technical Support 


If you need help deciding which documentation best meets your needs, call 800-343-4040 
your electronic, telephone, or direct mail order. 


before placing 


Electronic Orders 


To place an order at the Electronic Store, dial 800-DEC-DEMO (800-332-3366) using a 1200- 
mo em. If you need assistance using the Electronic Store, call 800-DIGITAL (800-344-4825). 


1200- or 2400-baud 


Telephone and Direct Mail Orders 


Call 

800-DIGITAL 

809-754-7575 
800-267-6215 

International _ 

Internal 1 __ 


Contact 

Digital Equipment Corporation 
P.O. Box CS2008 
Nashua, New Hampshire 03061 
Local Digital subsidiary 

Digital Equipment of Canada 
Attn: DECdirect Operations KAO2/2 
P.O. Box 13000 
100 Herzberg Road 
Kanata, Ontario, Canada K2K 2A6 

Local Digital subsidiary or 
approved distributor 

USASSB Order Processing - WMO/E15 
or 

U.S. Area Software Supply Business 
Digital Equipment Corporation 
Westminster, Massachusetts 01473 


Your Location 

Continental USA, 
Alaska, or Hawaii 

Puerto Rico 
Canada 


lFor internal orders, you must submit an Internal Software Order Form (EN-01740-07). 
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